用 System.Text.Json
替代 Newtonsoft.Json
在 .NET Core 3.0+ 或 .NET 5+ 环境中,
System.Text.Json是默认推荐方案,它原生支持 Span
JsonDocument或
JsonElement),且无反射开销。而
Newtonsoft.Json在高并发下容易因动态类型解析、字符串拼接和大量临时对象引发 GC 压力。
实操建议:
升级到 .NET 6+,确保使用System.Text.Json的最新稳定版(如 8.x) 避免在热路径中调用
JsonSerializer.Serialize<t>(obj)</t>泛型重载以外的变体(例如
Serialize(object)),否则会触发运行时类型发现 若需兼容旧版 .NET Framework,可保留
Newtonsoft.Json,但必须启用
JsonSerializerSettings.ConstructorHandling = ConstructorHandling.AllowNonPublicDefaultConstructor并预热
JsonSerializer实例
预热 JsonSerializerOptions
并复用实例
JsonSerializerOptions构造和配置过程涉及反射缓存初始化、属性映射构建等操作,在高并发请求中反复 new 它会导致 CPU 和内存抖动。
实操建议:
将JsonSerializerOptions声明为
static readonly字段,并在应用启动时一次性配置完成 禁用不必要的特性:设
PropertyNameCaseInsensitive = false(除非真需要)、
IncludeFields = false、
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull如需自定义转换器(如
DateTime格式),优先使用
JsonConverter<t></t>派生类而非 lambda 表达式,后者无法被缓存
用 JsonDocument.Parse
+ JsonElement
处理未知/动态结构
当反序列化目标类型不确定(如 API 网关、日志采集、泛型 webhook 接收器),直接绑定到强类型模型会触发完整对象构造,浪费资源;而
JsonDocument提供只读、零分配的 DOM 解析能力。
实操建议:
对原始 JSON 字节数组(ReadOnlyMemory<byte></byte>)直接调用
JsonDocument.Parse(buffer, options),避免先转成
string用
root.GetProperty("data").EnumerateArray() 等方法按需提取字段,不构造中间对象
注意:JsonDocument必须显式
.Dispose(),建议用
using语句块包裹,或在 ASP.NET Core 中配合
HttpContext.Request.BodyReader流式解析
避免在反序列化中触发字符串解码/编码
常见错误是把 UTF-8 字节流先转成
string再传给
JsonSerializer.Deserialize<t></t>,这会强制做一次 UTF-8 → UTF-16 解码,产生额外内存拷贝和 GC 压力。
实操建议:
始终优先使用JsonSerializer.Deserialize<t>(ReadOnlyMemory<byte>, options)</byte></t>或
DeserializeAsync<t>(Stream, options)</t>ASP.NET Core 中,
HttpRequest.Body是
Stream,可直接传入异步反序列化方法,无需读取全部内容到内存 若必须处理
string输入(如从 Redis 获取的 JSON 字符串),用
Encoding.UTF8.GetBytes(s)转为字节数组后解析,比用
JsonSerializer.Deserialize<t>(s)</t>更可控
var options = new JsonSerializerOptions
{
PropertyNameCaseInsensitive = false,
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
Converters = { new DateTimeConverter() }
};
// ✅ 正确:复用 options,直接解析字节流
var payload = Encoding.UTF8.GetBytes(jsonString);
var result = JsonSerializer.Deserialize<MyModel>(payload, options);
// ❌ 错误:隐式 string → UTF-16 → 再转 UTF-8,多一次编码转换
// var result = JsonSerializer.Deserialize<MyModel>(jsonString);
高并发下最易被忽略的是 JsonSerializerOptions的生命周期管理——它不是线程安全的可变对象,但本身是不可变的;真正危险的是在每次请求中 new 它,或者误以为可以在线程间共享一个未配置完成的实例。只要选项固定、复用、不修改,就能稳住序列化路径的性能基线。
