Azure部署ASP.NET WebAPI报错：无法加载System.Web.Http程序集

我之前帮不少开发者搞定过Azure部署时的这类程序集版本不匹配问题，既然你已经试过更新NuGet包和绑定重定向这些常规操作，那咱们从几个容易被忽略的细节入手排查：

有时候部署过程中会出现文件遗漏或旧版本残留的情况，你可以这么做：

• 打开Azure的Kudu调试控制台（直接访问https://<你的应用名称>.scm.azurewebsites.net/DebugConsole），进入site/wwwroot/bin目录，找到System.Web.Http.dll，右键查看它的属性版本，对比本地项目引用的版本是否一致。如果Azure上的是旧版本，说明部署时没把最新的dll传上去。
• 用Visual Studio发布时，记得勾选删除目标位置的额外文件选项，避免旧文件干扰；如果是用Zip包部署，一定要把本地bin文件夹里的所有文件（包括子目录）完整打包上传。

WebAPI相关的组件版本必须一致，否则很容易出现冲突：

• 打开项目的.csproj文件，搜索System.Web.Http，检查所有相关的PackageReference或HintPath是否都指向同一个版本（比如你报错里的5.0.0.0，或者你实际升级后的更高版本），把不一致的统一改成同一个版本。
• 在Visual Studio里右键项目→管理NuGet程序包，查看已安装的Microsoft.AspNet.WebApi系列包（比如Core、WebHost、Client等），确保所有包的版本完全相同，不要混合不同版本的组件。

你已经加了绑定重定向，但可能存在格式或范围问题：

• 确保重定向配置放在Web.config的<runtime>→<assemblyBinding>节点下，格式要准确，比如：

  <dependentAssembly>
    <assemblyIdentity name="System.Web.Http" publicKeyToken="31bf3856ad364e35" culture="neutral" />
    <!-- oldVersion要覆盖所有可能的旧版本范围，newVersion是你实际使用的版本 -->
    <bindingRedirect oldVersion="0.0.0.0-5.2.9.0" newVersion="5.2.9.0" />
  </dependentAssembly>
  

• 检查Web.Release.config里有没有删除重定向的转换规则，如果有的话注释掉，避免发布时重定向配置被清空。

Azure App Service的.NET版本和本地不一致也会导致加载异常：

• 登录Azure门户，找到你的App Service，进入配置→常规设置，查看“.NET Framework版本”是否和本地开发时使用的版本一致（比如本地用4.7.2，Azure就别选4.6）。如果项目兼容，尽量选和本地相同或更高的版本。

本地的bin/obj文件夹可能残留旧dll，导致部署带错文件：

• 右键解决方案→清理解决方案
• 手动删除所有项目下的bin和obj文件夹
• 右键解决方案→重新生成解决方案
• 再次发布到Azure

如果以上方法都没解决，可以去Azure的监控→日志流里查看更详细的错误日志，或者在Kudu里启用失败请求跟踪，看看具体是哪个依赖项触发了加载失败，这样能更精准定位问题。

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