.NET Framework 4.8与.NET 8 JSON序列化/反序列化差异适配咨询

我完全懂你现在的头疼——升级到.NET8后，JSON序列化的细微变化直接给老客户端的手动解析逻辑捅了娄子，那些硬写的解析代码容错性本来就差，一点格式变动就炸锅。咱们来一步步把.NET8的序列化行为掰回和.NET Framework4.8几乎一模一样的状态。

方案一：直接换回Newtonsoft.Json（最省心的1:1匹配） #

其实.NET Framework4.8默认就是用Newtonsoft.Json（也就是常说的Json.NET）处理Web API的JSON序列化的，所以在.NET8里直接切换回这个库，是最能保证和旧行为完全一致的方法，连边缘case都能覆盖：

1. 先安装NuGet包：Microsoft.AspNetCore.Mvc.NewtonsoftJson
2. 在服务配置里替换掉默认的System.Text.Json，改成用Newtonsoft：

builder.Services.AddControllers(options => 
    options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true)
    .AddNewtonsoftJson(options => 
    {
        // 匹配.NET Framework4.8的默认行为：不转义Unicode、不转义/
        options.SerializerSettings.StringEscapeHandling = StringEscapeHandling.Default;
        // 保持属性名不变，不做驼峰转换
        options.SerializerSettings.ContractResolver = new DefaultContractResolver();
        // 添加你之前的布尔值自定义转换器
        options.SerializerSettings.Converters.Add(new BooleanJsonConverter());
        // 匹配4.8：序列化空值（Newtonsoft默认就是这个行为，显式设置更稳妥）
        options.SerializerSettings.NullValueHandling = NullValueHandling.Include;
        // 匹配4.8：序列化只读属性
        options.SerializerSettings.IgnoreReadOnlyProperties = false;
        // 如果老系统用了Microsoft日期格式（/Date(123456789)/），就打开下面这行
        // options.SerializerSettings.DateFormatHandling = DateFormatHandling.MicrosoftDateFormat;
    });

这个配置基本上能让序列化输出和.NET Framework4.8完全一致，毕竟用的是同一个序列化库，只是在.NET8环境下运行而已。

方案二：精细调校System.Text.Json以贴近4.8行为 #

如果不想切换序列化库，那就要给System.Text.Json加更多细节配置，填补剩下的差异：

首先，你已经配置了UnsafeRelaxedJsonEscaping，这个确实能解决Unicode和/的转义问题——如果还是看到/被转义，可能是配置没到位，或者遇到了URI对象这类特殊场景。先把完整的配置补全：

builder.Services.AddControllers(options => 
    options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true)
    .AddJsonOptions(opts => 
    {
        // 自定义布尔值转换器
        opts.JsonSerializerOptions.Converters.Add(new BooleanJsonConverter());
        // 保持属性名不变，不做命名转换
        opts.JsonSerializerOptions.PropertyNamingPolicy = null;
        // 关闭严格转义：不转义Unicode、不转义/
        opts.JsonSerializerOptions.Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping;
        // 匹配4.8：序列化空值（System.Text.Json默认不序列化空值）
        opts.JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.Never;
        // 匹配4.8：序列化只读属性（System.Text.Json默认忽略）
        opts.JsonSerializerOptions.IgnoreReadOnlyProperties = false;
        // 匹配4.8：枚举序列化用名称（默认是，但显式设置更稳妥）
        opts.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
        // 如果老系统用了Microsoft日期格式，需要加自定义转换器处理
        // opts.JsonSerializerOptions.Converters.Add(new MicrosoftDateFormatJsonConverter());
    });

另外，要针对性测试一些典型场景：

• 包含Unicode的字符串：比如"你好，world"，确认输出是直接显示中文而非\u4F60\u597D...
• 包含/的字符串：比如"path/to/resource"，确认输出是"path/to/resource"而非"path\/to\/resource"
• 布尔值：确保你的BooleanJsonConverter和老框架的布尔序列化逻辑完全匹配（比如输出"true"/"false"而非其他格式）

最后小提醒 #

虽然从长期看，确实建议推动老客户端升级JSON解析逻辑（手动解析JSON本来就不是最佳实践），但短期内为了兼容旧系统，上面的两种方案都能帮你把.NET8的序列化行为拉回到和4.8几乎一致的状态。优先推荐方案一，因为Newtonsoft.Json就是老框架的原生实现，不会有隐藏的差异。

内容来源于stack exchange