Dapper需通过应用层统一封装实现软删除查询过滤：采用基类+泛型仓储自动追加IsDeleted=0、SQL模板参数化、AOP拦截或扩展Query方法，仅对ISoftDelete类型生效。
Dapper 本身不内置软删除查询过滤器或全局拦截机制，它只是一个轻量级 ORM 工具，负责 SQL 映射和执行。要实现类似 EF Core 中 HasQueryFilter 那样的“自动追加 IsDeleted = 0”效果，需在应用层主动控制——核心思路是：**统一封装查询逻辑，避免手写 SQL 漏掉条件，并通过约定或 AOP 方式降低侵入性。**
统一基类 + 泛型查询方法
定义一个仓储基类（如 BaseRepository），所有实体继承自带 IsDeleted 字段的基类（如 ISoftDelete）：
- 在
GetAll()、FindById()等方法中，自动拼接AND IsDeleted = 0 - 使用 Dapper 的
SqlBuilder或字符串插值（注意防注入）构建可复用查询模板 - 对需要查已删除数据的场景（如回收站），提供
GetAllWithDeleted()显式绕过
SQL 模板 + 参数化约定
把常用查询抽象成带占位符的 SQL 模板，例如：
SELECT * FROM {TableName} WHERE IsDeleted = 0 {WhereClause}
- 运行时替换
{TableName}和拼接{WhereClause}（确保只拼接安全字段） - 所有查询走这个模板，天然隔离软删除逻辑
- 配合
typeof(T).GetCustomAttribute自动获取表名，减少硬编码()
借助中间件或调用拦截（轻量 AOP）
若项目已用 Autofac / Castle Windsor / DynamicProxy，可对仓储接口做方法拦截：
- 识别方法名含
Get、Find、Select且返回集合或单个实体的方法 - 解析表达式树或方法参数，自动追加
IsDeleted = 0条件（适用于表达式参数场景） - 注意：Dapper 不解析 LINQ 表达式，所以该方式需配合自定义查询构建器，不能直接拦截
connection.Query()
扩展 Dapper 的 Query 方法（推荐）
为 IDbConnection 添加扩展方法，覆盖常用查询入口：
-
QuerySoft：自动在(sql, param) WHERE后追加AND IsDeleted = 0（需解析原始 SQL，较重但可控） -
QueryWithFilter：显式传入过滤条件，灵活支持多租户、状态等复合场景(sql, param, filter = "IsDeleted = 0") - 关键点：只对明确标记为“软删实体”的类型（如
T : ISoftDelete）才生效，避免误伤其他表
基本上就这些。没有银弹，但靠约定+封装+少量扩展，就能在 Dapper 里稳稳落地软删除查询逻辑，既保持轻量，又不失一致性。
