容器映像中的默认控制台记录器格式设置

2025-06-18

容器中 aspnet 配置的默认控制台格式化程序已更改。

以前的行为

在 .NET 6 的早期服务版本中，aspnet 容器映像在配置时将 Logging__Console__FormatterName 环境变量设置为 Json。这导致控制台输出的格式与以下内容类似：

{"EventId":0,"LogLevel":"Information","Category":"Microsoft.Hosting.Lifetime","Message":"Now listening on: http://localhost:7000/","State":{"Message":"Now listening on: http://localhost:7000/","address":"http://localhost:7000/","{OriginalFormat}":"Now listening on: {address}"}}
{"EventId":0,"LogLevel":"Information","Category":"Microsoft.Hosting.Lifetime","Message":"Now listening on: http://localhost:7001/","State":{"Message":"Now listening on: http://localhost:7001/","address":"http://localhost:7001/","{OriginalFormat}":"Now listening on: {address}"}}
{"EventId":0,"LogLevel":"Information","Category":"Microsoft.Hosting.Lifetime","Message":"Now listening on: http://localhost:7002/","State":{"Message":"Now listening on: http://localhost:7002/","address":"http://localhost:7002/","{OriginalFormat}":"Now listening on: {address}"}}
{"EventId":0,"LogLevel":"Information","Category":"Microsoft.Hosting.Lifetime","Message":"Application started. Press Ctrl\u002BC to shut down.","State":{"Message":"Application started. Press Ctrl\u002BC to shut down.","{OriginalFormat}":"Application started. Press Ctrl\u002BC to shut down."}}
{"EventId":0,"LogLevel":"Information","Category":"Microsoft.Hosting.Lifetime","Message":"Hosting environment: Development","State":{"Message":"Hosting environment: Development","envName":"Development","{OriginalFormat}":"Hosting environment: {envName}"}}
{"EventId":0,"LogLevel":"Information","Category":"Microsoft.Hosting.Lifetime","Message":"Content root path: C:\\source\\temp\\web50","State":{"Message":"Content root path: C:\\source\\temp\\web50","contentRoot":"C:\\source\\temp\\web50","{OriginalFormat}":"Content root path: {contentRoot}"}}

新行为

从 .NET 6.0.5 开始， aspnet 容器映像默认具有 Logging__Console__FormatterName 未设置的环境变量。这会导致简单、多行、可读的控制台输出，如下所示：

warn: Microsoft.AspNetCore.Server.HttpSys.MessagePump[37]
      Overriding address(es) ''. Binding to endpoints added to UrlPrefixes instead.
info: Microsoft.Hosting.Lifetime[0]
      Now listening on: http://localhost:7000/
info: Microsoft.Hosting.Lifetime[0]
      Now listening on: http://localhost:7001/
info: Microsoft.Hosting.Lifetime[0]
      Now listening on: http://localhost:7002/
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\source\temp\web50

已引入的版本

.NET 6.0.5 （2022 年 5 月服务）

破坏性变更的类型

此更改可能会影响源兼容性。

更改原因

在 .NET 6 GA 版本中引入使用 JSON 格式的更改时，它打破了许多依赖于原始简单格式的方案，如 dotnet/dotnet-docker#2725 中所述。

建议的措施

如果要继续使用 JSON 格式，可以通过将环境变量值设置为 Logging__Console__FormatterNameJson 来配置容器以启用该格式。

受影响的 API

没有。

另请参阅

dotnet/dotnet-docker#3706

通过