C# Dapper如何记录执行的SQL Dapper SQL日志记录方法

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C# Dapper如何记录执行的SQL Dapper SQL日志记录方法

2025-12-15

浏览次数：次

返回列表

推荐使用 Dapper v2.1+ 的 IDbCommandInterceptor 实现 SQL 日志，通过重写 BeforeExecute 方法记录 CommandText 和 Parameters；兼容旧版可包装 IDbConnection；手动拼接 SQL 仅限临时调试。

c# dapper如何记录执行的sql dapper sql日志记录方法

在使用 Dapper 时，默认不输出执行的 SQL 语句，但可以通过几种轻量、实用的方式实现 SQL 日志记录，无需引入重型 ORM 日志框架（如 Serilog + EF 集成）。核心思路是利用 Dapper 的 IDbConnection 扩展能力或包装连接对象，捕获命令执行前的 SQL 和参数。

方法一：使用 IDbCommandInterceptor（推荐，Dapper v2.1+）

Dapper 2.1 起原生支持拦截器（IDbCommandInterceptor），可统一监听所有命令执行过程。这是最干净、侵入性最小的方式。

创建一个实现 IDbCommandInterceptor 的类，重写 BeforeExecute 方法，在其中记录 SQL、参数、连接信息
通过 Dapper.DefaultCommandInterceptor = new YourSqlLogger(); 全局注册
BeforeExecute 中可访问 command.CommandText、command.Parameters（注意：参数值需遍历获取，部分参数类型需特殊处理，如 DbNull 或数组）

示例片段：

  public class SqlLogger : IDbCommandInterceptor
  {
    public void BeforeExecute(IDbCommand command)
    {
      var sql = command.CommandText;
      var paramStr = string.Join(", ", command.Parameters.Cast().Select(p => $"{p.ParameterName}={p.Value ?? "NULL"}"));
      Console.WriteLine($"[SQL] {sql} | Params: {paramStr}");
    }
    // 其他方法可空实现
  }

启动时注册：Dapper.DefaultCommandInterceptor = new SqlLogger();

MarsCode

字节跳动旗下的免费AI编程工具

339 查看详情 MarsCode

方法二：包装 IDbConnection（兼容老版本 Dapper）

适用于 Dapper IDbConnection，在 CreateCommand() 返回前注入日志逻辑。

封装原始连接（如 SqlConnection），所有方法委托调用
重写 CreateCommand()，返回自定义 IDbCommand 包装器
在包装后的 Execute* 方法中记录 SQL，再调用原命令执行
适合单元测试 Mock，也便于结合 DI 容器（如注册为 Scoped 服务）

方法三：手动拼接 SQL（仅调试用，不推荐生产）

借助 Dapper.SqlMapper.GenerateSql（内部 API，不稳定）或第三方扩展（如 DapperExtensions），或自己解析匿名对象/ExpandoObject 参数生成占位符 SQL。但该方式无法还原真实执行 SQL（尤其含动态条件、多表 JOIN 时），且不包含实际参数值类型和 DbNull 处理，仅适合快速验证逻辑。