.NET7 ASP.NET Core中Serilog配置自定义格式提供器找不到类问题

API 探路者

2026-7-26

解决Serilog通过appsettings.json加载自定义格式提供器找不到类型的问题

几个可行的解决步骤：

1. 给类型名称加上完整程序集信息

Serilog从配置字符串解析类型时，得用完整的类型限定名（包含程序集名称）。如果你的程序集名称就是TestProj（和项目名一致），把配置里的格式改成这样：

"formatProvider": "TestProj.Formatting.Iso8601Formatter, TestProj"

后面的, TestProj就是程序集名，要和输出的dll文件名完全一致，要是项目名有特殊字符，得确认实际程序集名称。

2. 检查自定义格式器的访问权限

必须保证Iso8601Formatter是public修饰的，Serilog加载不了非公开的类。比如：

namespace TestProj.Formatting
{
    public class Iso8601Formatter : IFormatProvider, ICustomFormatter
    {
        // 你的实现代码
    }
}

3. 确认Serilog的Using配置

配置里的Using节点要明确包含自定义类型所在的程序集，还有Serilog sink的程序集，比如：

"Serilog": {
    "Using": ["TestProj", "Serilog.Sinks.Console"],
    "WriteTo": [
        {
            "Name": "Console",
            "Args": {
                "formatProvider": "TestProj.Formatting.Iso8601Formatter, TestProj"
            }
        }
    ]
}

4. 代码+配置结合的备选方案

要是上面的方法都不管用，干脆在代码里先初始化格式器，再合并配置：

var config = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .Build();

var formatter = new Iso8601Formatter();

Log.Logger = new LoggerConfiguration()
    .ReadFrom.Configuration(config)
    // 用代码里的formatter覆盖配置里的设置
    .WriteTo.Console(formatProvider: formatter)
    .CreateLogger();