使用Dapper与PostgreSQL时如何获取实际执行的查询语句

针对你用Dapper搭配PostgreSQL想要记录实际执行查询语句的需求，这里有几个靠谱的方案——毕竟Npgsql和SQL Server的生态不一样，咱们换更贴合PostgreSQL的方式来实现：

1. 用Npgsql内置日志直接输出SQL #

Npgsql本身自带完善的日志功能，配置后就能直接输出执行的SQL语句（包括带实际参数值的最终语句）。最简单的是用控制台日志：

NpgsqlLogManager.Provider = new ConsoleLoggingProvider(NpgsqlLogLevel.Debug, true, true);

配置完后，Npgsql会把包括SQL执行细节在内的调试信息打印到控制台。如果不想输出太多无关内容，你可以自定义日志提供者，只过滤Command相关的日志项，精准捕获SQL语句。

2. 用Dapper拦截器全局捕获（Dapper 2.0+） #

从Dapper 2.0开始，官方支持了拦截器功能，能直接在Dapper层面拿到执行的SQL和参数，非常适合全局日志记录：

public class SqlLoggingInterceptor : IDapperInterceptor
{
    public void OnCommandExecuting(IDbCommand command, CommandExecutingContext context)
    {
        // 获取原始SQL模板
        var sql = command.CommandText;
        // 获取实际参数键值对
        var parameters = command.Parameters.Cast<IDbDataParameter>()
            .ToDictionary(p => p.ParameterName, p => p.Value);
        
        // 这里可以把SQL和参数写入日志系统、文件等
        Console.WriteLine($"执行SQL: {sql}");
        Console.WriteLine($"参数: {string.Join(", ", parameters.Select(kv => $"{kv.Key}={kv.Value}"))}");
    }

    // 不需要的接口方法留空实现即可
    public void OnCommandExecuted(IDbCommand command, CommandExecutedContext context) { }
    public void OnReaderClosing(IDataReader reader, ReaderClosingContext context) { }
}

然后在启动时注册这个拦截器：

// 可选：适配PostgreSQL的下划线命名与C#驼峰命名映射
Dapper.DefaultTypeMap.MatchNamesWithUnderscores = true;
Dapper.DapperConfiguration.Instance.AddInterceptor(new SqlLoggingInterceptor());

这种方式不依赖Npgsql的特定API，通用性强，还能同时拿到SQL和参数，排查问题非常方便。

3. 监听NpgsqlConnection的局部事件 #

如果只是想调试某个特定连接的执行情况，直接订阅NpgsqlConnection的事件更灵活：

using var connection = new NpgsqlConnection(connectionString);
// 订阅CommandExecuting事件，捕获执行前的SQL和参数
connection.CommandExecuting += (sender, args) =>
{
    var sql = args.Command.CommandText;
    var parameters = args.Command.Parameters.Cast<NpgsqlParameter>()
        .ToDictionary(p => p.ParameterName, p => p.Value);
    
    Console.WriteLine($"执行SQL: {sql}");
    Console.WriteLine($"参数: {string.Join(", ", parameters.Select(kv => $"{kv.Key}={kv.Value}"))}");
};

// 执行Dapper查询
var result = connection.Query<YourModel>("SELECT * FROM your_table WHERE id = @Id", new { Id = 1 });

这个方法只对当前连接生效，适合临时调试，不会影响全局逻辑。

总结 #

• 全局记录所有SQL：优先选Dapper拦截器或Npgsql全局日志
• 局部调试特定连接：用NpgsqlConnection事件监听更灵活

这些方案都能拿到参数的实际值，比单纯看模板SQL更有助于定位问题。

内容的提问来源于stack exchange，提问作者severin