System.Text.Json.dll 是 .NET 平台 System.Text.Json 程序集的运行时文件,在 Windows 上通常随 .NET Runtime、.NET Desktop Runtime 或应用发布目录分发。它的核心定位是提供高性能、低分配的 JSON 处理能力,并围绕 UTF-8 文本构建序列化管道。其核心类型包括 JsonSerializer、JsonDocument、JsonElement、Utf8JsonReader、Utf8JsonWriter、JsonSerializerOptions、JsonConverter 与 JsonNamingPolicy。JsonSerializer 负责将 CLR 对象图转换为 JSON 字符串或 UTF-8 字节,也能从 JSON 文本、流、管道中还原对象;Utf8JsonReader 提供只进、低分配的读取器,适合大体积 JSON 和高吞吐场景;Utf8JsonWriter 提供快速写入与转义;JsonDocument 提供只读 DOM,便于随机访问节点;JsonElement 表示 DOM 中的值;JsonConverter 支持自定义类型转换,JsonSerializerOptions 控制命名策略、忽略空值、大小写、引用处理、最大深度、数字处理与源生成。该 DLL 还参与 ASP.NET Core 请求响应、System.Net.Http.Json、配置绑定、日志结构化、SignalR、gRPC JSON 转码、Azure SDK 与 EF Core 等组件的 JSON 数据交换。因此,它是 Windows 上 .NET 应用、服务和安装程序的基础依赖之一。
缺少 System.Text.Json.dll 时,影响会沿程序集加载、类型解析和运行时调用三层扩散。首先,应用可能无法启动,弹出 FileNotFoundException、Could not load file or assembly、System.IO.FileLoadException 或 BadImageFormatException,提示找不到 System.Text.Json 或其版本不匹配。其次,即使入口程序启动,调用 JsonSerializer.Serialize、Deserialize、JsonDocument.Parse 等 API 时也可能抛出 TypeLoadException、MissingMethodException、TypeInitializationException、FileNotFoundException。依赖 System.Text.Json 的库会继续失败,例如 ASP.NET Core 无法处理 JSON 请求,HttpClient 扩展无法读写 JSON,配置系统无法加载 appsettings.json,EF Core 或 Azure SDK 无法序列化模型。服务端可能返回 HTTP 500,桌面程序可能白屏、闪退或功能按钮无响应,安装程序可能中断。常见诱因包括部署遗漏、发布目录未复制依赖、杀毒软件隔离、NuGet 包版本冲突、运行时版本不完整、单文件发布裁剪、DLL 被替换或损坏。排查时应检查输出目录、绑定日志、dotnet --list-runtimes、NuGet 依赖树与 copy local 设置;修复可重新安装对应 .NET 运行时、修复应用、统一包版本、清理 NuGet 缓存、重新发布自包含包或补齐依赖。