最直接的方式是调用 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<appdbcontext>(options => options.UseSqlServer(connStr).LogTo(Console.WriteLine, LogLevel.Information));</appdbcontext>或通过
ILoggerFactory统一配置:
builder.Services.AddLogging(b => b.AddConsole().AddFilter(DbLoggerCategory.Database.Command.Name, LogLevel.Information));再在 DbContext 中调用
optionsBuilder.UseLoggerFactory(loggerFactory)(注意:不要每次新建 factory 实例)
基本上就这些。不需要复杂中间件,也不依赖第三方库,EF Core 内置的
LogTo已足够轻量又灵活。
