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