RestSharp 110在.NET6 Azure Functions中的System.Text.Json依赖问题

开发者阿泽

2026-7-22

RestSharp 110+ 在.NET6 Azure Functions中的依赖问题及解决方法

为什么.NET6环境下RestSharp 110+需要依赖System.Text.Json >=7.0.2？

RestSharp 110版本对JSON序列化模块做了重构，引入了System.Text.Json 7.0.2中的新特性或关键修复——比如特定JsonSerializerOptions的扩展配置、复杂JSON结构的处理逻辑，或是性能优化的API，这些功能在System.Text.Json 6中并不存在。为了保证跨.NET版本（.NET6/.NET7/.NET8）的序列化行为一致，维护团队统一要求.NET6及以上环境依赖该版本的System.Text.Json，避免不同版本下的序列化差异导致潜在bug。

解决方案

强制加载指定版本的System.Text.Json
在你的Azure Functions项目文件（.csproj）中添加以下配置，确保项目打包时包含System.Text.Json 7.0.2，并让运行时优先加载本地bin目录中的版本：

<ItemGroup>
  <PackageReference Include="System.Text.Json" Version="7.0.2" />
</ItemGroup>
<PropertyGroup>
  <_FunctionsSkipCleanOutput>true</_FunctionsSkipCleanOutput>
</PropertyGroup>

同时在host.json中添加运行时探测路径配置：

{
  "version": "2.0",
  "runtime": {
    "assemblyBindingRedirects": {
      "probingPaths": ["./bin"]
    }
  }
}

切换到Newtonsoft.Json序列化器
放弃使用RestSharp默认的System.Text.Json实现，改用Newtonsoft.Json。先安装RestSharp.Newtonsoft.Json包，然后在初始化RestClient时指定序列化器：
```
var restClient = new RestClient();
restClient.UseNewtonsoftJson();
```
这种方式完全避开System.Text.Json的版本冲突，适合无法升级依赖或运行时的场景。
升级Azure Functions运行时与目标框架
如果项目兼容性允许，将Azure Functions运行时升级到v4并将项目目标框架切换为.NET7。此时Azure Functions默认会加载System.Text.Json 7.x版本，与RestSharp的依赖要求匹配，从根源上解决版本问题。