System.Text.Json.JsonSerializerOptions是否线程安全？ASP.NET Core场景答疑

你完全可以使用第一种静态只读成员的写法，这不仅是线程安全的，更是性能更优的方案，原因如下：

核心依据：JsonSerializerOptions的线程安全性 #

JsonSerializerOptions的设计初衷就是支持多线程共享使用——只要你在初始化完成后不再修改它的任何配置（比如添加转换器、修改属性），它就是线程安全的。这类配置对象被设计为不可变类型，初始化后固定状态，可安全供所有并发线程复用。

两种写法的对比 #

第一种（静态只读实例） #

public static class JsonOptionsProviders
{
    public static readonly JsonSerializerOptions ForPreferences = new() { Converters = { new DateOnlyJsonConverter(), new TimeOnlyJsonConverter() } };
}

• 优势：仅在程序启动时创建一次实例，避免重复初始化对象带来的内存开销和GC压力，高并发场景下性能更优。
• 注意点：必须确保初始化后绝对不修改这个静态实例的任何属性（比如不要在运行时动态添加转换器），否则会引发线程安全问题。readonly修饰符已经能防止实例被重新赋值，只要内部配置不改动就无风险。

第二种（每次返回新实例） #

public static class JsonOptionsProviders
{
    public static JsonSerializerOptions ForPreferences => new() { Converters = { new DateOnlyJsonConverter(), new TimeOnlyJsonConverter() } };
}

• 特点：每次调用都会创建新实例，虽然线程安全，但会重复生成相同配置的对象，增加不必要的资源消耗，高频调用场景下会影响性能。

额外建议 #

如果你的项目已经使用ASP.NET Core依赖注入系统，也可以通过IOptions<T>来注册和获取自定义Json配置，更符合框架规范：

// Program.cs
builder.Services.Configure<JsonSerializerOptions>("Preferences", options =>
{
    options.Converters.Add(new DateOnlyJsonConverter());
    options.Converters.Add(new TimeOnlyJsonConverter());
});

// 使用时注入IOptionsSnapshot<JsonSerializerOptions>或IOptions<JsonSerializerOptions>
public class MyService
{
    private readonly JsonSerializerOptions _jsonOptions;
    public MyService(IOptionsSnapshot<JsonSerializerOptions> options)
    {
        _jsonOptions = options.Get("Preferences");
    }
}

这种方式同样能保证实例复用和线程安全，但如果只是简单的全局共享配置，静态只读类的写法已经足够简洁高效。

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