Dapper如何实现软删除查询 Dapper全局查询过滤器思路 返回列表

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 里稳稳落地软删除查询逻辑，既保持轻量，又不失一致性。