ASP.NET Core 5中绑定JsonDocument与JsonElement的差异及安全选型问题

两种绑定方式的安全性对比 #

两种方式的核心差异在于生命周期关联逻辑，适用场景不同：

• 绑定到JsonElement时，ASP.NET Core 底层会先解析生成JsonDocument，提取其RootElement后自动释放原始的JsonDocument对象。如果你所有对JSON的操作（读取指定字段、提取完整JSON字符串入库、生成内部事件）都在当前请求的同步/await执行流程内完成，不会把JsonElement传递到请求上下文之外的后台异步任务中，这种方式是安全的，也不需要手动处理资源释放。

  注意：如果把JsonElement传到请求结束后才执行的逻辑中，会因为父级JsonDocument已被释放，访问时抛出ObjectDisposedException异常。

• 绑定到JsonDocument时，你拿到的是完整的解析后文档对象，生命周期完全由你控制，只要在释放前访问都不会出现资源已释放的问题，适用场景更广泛，也更安全，不存在不小心传到异步逻辑就报错的隐患。

两种方式都可以通过GetRawText()方法拿到完整的原始JSON字符串，满足你入库的需求。

JsonDocument的释放规则 #

ASP.NET Core 5.0的模型绑定逻辑不会自动释放绑定生成的JsonDocument实例，必须由开发者手动释放。
JsonDocument内部使用了池化内存来优化解析性能，如果不手动释放，内存不会归还到对象池，高并发场景下会出现明显的内存泄漏问题。你给出的用using块包裹处理逻辑的写法是完全正确的，是官方推荐的最佳实践。

选型建议 #

• 如果你能确保JSON对象的所有使用都在当前请求的执行流程内完成，选JsonElement更省心，不需要处理释放逻辑。
• 如果有跨请求上下文使用JSON对象的需求，或者想彻底规避资源已释放的异常风险，选JsonDocument，同时务必用using块保证资源释放。

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