Serilog配置：如何在appsettings.json中传递string[]类型的propertyColumns参数？

我之前也踩过这个坑！其实问题出在Serilog配置系统对数组参数的解析规则上，尤其是给AzureTableStorageWithProperties配置propertyColumns这个字符串数组的时候，得用正确的JSON格式或者环境变量语法才行。

1. 正确的appsettings.json配置方式 #

你需要在WriteTo节点的Args里，把propertyColumns明确定义为JSON数组，Serilog.Settings.Configuration会自动把它解析成string[]类型传递给对应的方法。示例配置如下：

{
  "Serilog": {
    "Using": [ "Serilog.Sinks.AzureTableStorage" ],
    "MinimumLevel": "Information",
    "WriteTo": [
      {
        "Name": "AzureTableStorageWithProperties",
        "Args": {
          "connectionString": "你的Azure存储连接字符串",
          "propertyColumns": [ "RequestId", "UserName", "OperationName" ]
        }
      }
    ]
  }
}

⚠️ 注意：一定要在Using数组里加入Serilog.Sinks.AzureTableStorage，不然Serilog会找不到这个Sink的写入方法，直接报错。

2. 环境变量的配置语法（冒号分隔格式） #

如果你用环境变量来配置，有两种可行的方式：

• 逗号分隔单个变量：适合数组元素里没有逗号的场景

  Serilog__WriteTo__0__Args__propertyColumns=RequestId,UserName,OperationName
  

• 索引逐个设置：适合元素包含逗号或者需要明确控制顺序的场景

  Serilog__WriteTo__0__Args__propertyColumns__0=RequestId
  Serilog__WriteTo__0__Args__propertyColumns__1=UserName
  Serilog__WriteTo__0__Args__propertyColumns__2=OperationName
  

3. 常见排查点 #

如果还是不行，可以检查这几个地方：

• 确认Serilog.Settings.Configuration和Serilog.Sinks.AzureTableStorage都是最新稳定版，旧版本可能存在数组解析的bug；
• 检查参数名拼写：propertyColumns是方法的参数名，JSON里的键要和它一致（Serilog对大小写不敏感，但最好严格匹配避免问题）；
• 启用Serilog的自我诊断日志，排查配置解析错误：

  // 在初始化Serilog之前添加这段代码
  Serilog.Debugging.SelfLog.Enable(msg => Console.WriteLine(msg));
  

  这样如果配置解析时出现类型不匹配或者找不到参数的问题，会在控制台输出详细错误信息。

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