System.Net.Http.Json.dll 是 .NET 平台中承载 System.Net.Http.Json 命名空间的程序集,通常由 NuGet 包 System.Net.Http.Json 或 ASP.NET Core 共享框架提供。它把 HttpClient 与 System.Text.Json 连接起来,使开发者可以直接发送和接收 JSON 数据,而不必手动创建 StringContent、设置 application/json、再调用 JsonSerializer。其核心价值在于统一、简洁、类型安全地完成 HTTP JSON 序列化与反序列化。
| 场景 | 表现 |
|---|---|
| 编译期缺少引用 | 无法识别 System.Net.Http.Json 命名空间,出现 CS0234、CS1061 等错误,扩展方法不可用。 |
| 运行时缺失程序集 | 调用相关 API 时可能抛出 FileNotFoundException、FileLoadException、TypeLoadException 或 MissingMethodException。 |
| 部署不完整 | 应用启动或首次发起 JSON HTTP 请求时失败,日志提示找不到 System.Net.Http.Json。 |
| 版本冲突 | 不同包版本或共享框架版本不一致,可能导致绑定重定向、加载失败或行为差异。 |
排查时应确认目标框架、NuGet 包版本、发布模式与运行时版本一致;必要时显式引用 System.Net.Http.Json 包,或在自包含发布中确保该 DLL 随应用输出。