如何在App.config中配置AWS.Logger.SeriLog？JSON转XML配置时textFormatter项异常解决

你遇到的异常核心原因是：Serilog的XML配置对WriteTo数组项的处理逻辑和JSON完全不同——XML里不能直接通过AWSSeriLog名称关联参数，必须通过数组索引定位每个WriteTo条目，再明确指定其Args参数。

Correct XML Configuration #

这里是匹配你原JSON配置的完整可运行XML版本：

<appSettings>
  <!-- Minimum Level Settings -->
  <add key="serilog:minimum-level" value="Information" />
  <add key="serilog:minimum-level:override:System" value="Warning" />
  <add key="serilog:minimum-level:override:Microsoft" value="Warning" />
  <add key="serilog:minimum-level:override:Microsoft.Hosting" value="Warning" />

  <!-- AWS Logger-specific Settings -->
  <add key="serilog:region" value="us-east-1" />
  <add key="serilog:log-group" value="MyLogGroup" />
  <add key="serilog:library-log-file-name" value="Logs/serilog-aws-errors.txt" />

  <!-- Serilog Provider References (Array Index Format) -->
  <add key="serilog:using:0" value="AWS.Logger.SeriLog" />

  <!-- Log Enrichers -->
  <add key="serilog:enrich:0" value="WithMachineName" />
  <add key="serilog:enrich:1" value="FromLogContext" />
  <add key="serilog:enrich:2" value="WithExceptionDetails" />
  <add key="serilog:enrich:3" value="WithAssemblyInformationalVersion" />

  <!-- AWS Serilog Sink (Fixed Args Syntax) -->
  <add key="serilog:write-to:0.name" value="AWSSeriLog" />
  <add key="serilog:write-to:0.args.textFormatter" value="Serilog.Formatting.Json.JsonFormatter, Serilog" />
</appSettings>

Key Fixes Explained #

1. WriteTo Args Syntax
   你原来的serilog:write-to:AWSSeriLog.textFormatter改成了serilog:write-to:0.args.textFormatter：

   • 0代表第一个WriteTo数组项（Serilog XML配置用索引处理数组，从0开始）
   • args.前缀明确标识这是该写入器的参数

2. Using Array Format
   把serilog:using:AWSSeriLog改成serilog:using:0：这是Serilog处理数组型配置的标准方式，避免多个Using项时的名称冲突。

JSON-to-XML Naming Rules for AWS.Logger.SeriLog #

Serilog的XML配置遵循扁平化层级+索引标识数组的规则，对应JSON结构的转换逻辑如下：

1. Root Level Properties
   JSON根节点的直接属性（如Region、LogGroup）转成serilog:kebab-case-name：

   • JSON: "Region": "us-east-1" → XML: <add key="serilog:region" value="us-east-1" />

2. Nested Objects
   嵌套对象（如MinimumLevel.Override）用冒号(:)分隔层级，同时转为kebab-case：

   • JSON: "MinimumLevel": { "Override": { "System": "Warning" } } → XML: <add key="serilog:minimum-level:override:system" value="Warning" />

3. Arrays
   数组类型（Using、Enrich、WriteTo）必须用:index标识元素位置：

   • Using数组: JSON: "Using": [ "AWS.Logger.SeriLog" ] → XML: <add key="serilog:using:0" value="AWS.Logger.SeriLog" />
   • WriteTo数组: 每个数组项是包含Name和Args的对象，需先通过索引定位，再指定子属性（如上面的write-to:0.name和write-to:0.args.textFormatter）

4. No-Value Enrichers
   你原来的<add key="serilog:enrich:WithMachineName" />写法也能被识别，但用索引格式（serilog:enrich:0）更符合标准，也方便后续添加带参数的 enrichers。

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