最直接的方式是调用 LogTo(Console.WriteLine),一行代码即可将SQL执行、连接、事务等关键操作输出到控制台,适合开发调试;支持敏感数据日志、按类别/级别过滤、单行时间戳格式及ASP.NET Core统一配置。

最直接的方式是调用 LogTo(Console.WriteLine),一行代码就能把 SQL 执行、连接、事务等关键操作输出到控制台,适合开发调试。
基础配置:一行启用控制台日志
在 DbContext 的 OnConfiguring 方法里写:
-
optionsBuilder.LogTo(Console.WriteLine);—— 默认输出所有 Information 及以上级别日志 - 加上
.EnableSensitiveDataLogging()可显示实际参数值(如@p0 = 'admin'),仅限开发环境 - 无需额外 NuGet 包,
Microsoft.Extensions.Logging已随 EF Core 自动引入
按需过滤:只看关键操作
避免日志刷屏,可指定事件类型或日志类别:
- 只记录 SQL 命令和查询:
optionsBuilder.LogTo(Console.WriteLine, new[] { DbLoggerCategory.Database.Command.Name, DbLoggerCategory.Query.Name }); - 只记录慢查询(需自行解析):
LogTo(message => { if (message.Contains("CommandExecuted") && message.Contains("Elapsed:100")) Console.WriteLine(message); }) - 限制级别为 Warning 以上:
LogTo(Console.WriteLine, LogLevel.Warning),跳过常规执行日志
结构更清晰:带时间戳和单行格式
提升可读性,尤其在快速滚动时:
- 启用本地时间 + 单行输出:
optionsBuilder.LogTo(Console.WriteLine, options: DbContextLoggerOptions.LocalTime | DbContextLoggerOptions.SingleLine); - 效果示例:
[2025-12-15 11:42:03] Executed DbCommand (12ms) [Parameters=[@p0='user1'], CommandType='Text', CommandTimeout='30'] SELECT ...
ASP.NET Core 中统一管理(推荐用于 Web 项目)
避免每个 DbContext 重复配置,改在 Program.cs 注入全局 logger factory:
- 注册时启用控制台并过滤数据库命令:
builder.Services.AddDbContext(options => options.UseSqlServer(connStr).LogTo(Console.WriteLine, LogLevel.Information)); - 或通过
ILoggerFactory统一配置:builder.Services.AddLogging(b => b.AddConsole().AddFilter(DbLoggerCategory.Database.Command.Name, LogLevel.Information)); - 再在 DbContext 中调用
optionsBuilder.UseLoggerFactory(loggerFactory)(注意:不要每次新建 factory 实例)
基本上就这些。不需要复杂中间件,也不依赖第三方库,EF Core 内置的 LogTo 已足够轻量又灵活。










