Azure WebJob本地正常运行但云端失败，求助排查Newtonsoft.Json异常

看起来你碰到了Azure WebJob部署后常见的程序集版本冲突问题——本地跑的好好的，一上云端就因为Newtonsoft.Json版本不匹配炸了。我来给你拆解一下可能的原因和解决办法：

核心原因分析 #

这个FileLoadException本质是程序集绑定失败：你的WebJob代码引用了Newtonsoft.Json 9.0.0.0，但Azure云端加载的却是另一个版本的程序集，或者找不到指定版本。本地正常是因为你的开发环境里所有依赖的程序集版本是一致的，而云端环境可能存在其他依赖（比如WebJobs SDK本身、其他第三方包）拉进来了不同版本的Newtonsoft.Json，或者绑定重定向没生效。

具体解决步骤 #

• 确认项目NuGet包版本一致性
  右键你的WebJob项目→「管理NuGet包」，找到Newtonsoft.Json，确认版本是9.0.0.0。同时检查其他依赖包（比如Microsoft.Azure.WebJobs系列）的依赖项，看有没有强制要求更高/更低版本的Newtonsoft.Json。如果有冲突，要么升级/降级Newtonsoft.Json到兼容版本，要么调整其他包的版本。

• 添加/修复程序集绑定重定向
  如果是.NET Framework项目，在App.config里添加绑定重定向规则，把所有版本的Newtonsoft.Json都指向你实际使用的版本：

  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Newtonsoft.Json" 
                          publicKeyToken="30ad4fe6b2a6aeed" 
                          culture="neutral" />
        <!-- 把oldVersion范围覆盖到你可能遇到的版本，newVersion设为你项目用的版本 -->
        <bindingRedirect oldVersion="0.0.0.0-9.0.0.0" newVersion="9.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
  

  要是你用的是.NET Core/.NET 5+项目，需要在.csproj文件里开启自动绑定重定向：

  <PropertyGroup>
    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
    <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
  </PropertyGroup>
  

• 验证部署包中的DLL版本
  登录Azure Kudu控制台（访问https://<你的WebApp名称>.scm.azurewebsites.net/DebugConsole），进入WebJob的部署目录：site\wwwroot\app_data\jobs\continuous\<你的Job名称>（如果是触发型Job路径是triggered）。找到Newtonsoft.Json.dll，右键查看属性里的文件版本，确认是不是9.0.0.0。如果版本不对或者文件缺失，重新打包部署，确保NuGet包的输出目录正确，没有被.gitignore或者部署脚本排除。

• 调整Azure环境配置避免全局程序集干扰
  有时候Azure Web Apps的全局程序集会和你的本地依赖冲突。可以在Azure Portal中找到你的Web应用→「配置」→「应用程序设置」，添加一个新的设置：

  • 名称：WEBSITE_LOAD_USER_PROFILE
  • 值：1
    这个设置会让WebJob加载用户配置，优先使用你部署的本地程序集，而不是全局的。

• 更新WebJobs SDK到兼容版本
  如果你的Microsoft.Azure.WebJobs SDK版本比较旧，可能和Newtonsoft.Json 9.0.0.0存在兼容性问题。尝试把WebJobs相关的NuGet包更新到最新稳定版本，看看是否能自动解决版本依赖冲突。

额外排查技巧 #

如果以上方法都没解决，可以在本地启用**融合日志（Fusion Log）**来追踪程序集加载过程，找出到底是哪个路径加载了不匹配的Newtonsoft.Json。具体操作是用管理员身份打开Developer Command Prompt for Visual Studio，运行：

fuslogvw.exe

然后配置日志记录程序集绑定失败的情况，再本地运行WebJob，就能看到详细的加载路径和版本信息，对应到云端环境排查即可。

内容的提问来源于stack exchange，提问作者Federico Degrandis