Azure WebApp调用API出现HTTP Error 500.0如何解决？

1. 查看详细错误日志 #

Azure WebApp默认不会展示具体错误细节，需要主动获取日志信息定位问题：

• 登录Azure门户，进入目标WebApp资源，在监测 > 日志流中实时查看请求处理时的异常输出，抓取具体的错误堆栈。
• 也可修改web.config开启详细日志记录：

<system.webServer>
  <httpErrors errorMode="Detailed" />
  <aspNetCore processPath="dotnet" arguments=".\YourWebApp.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
</system.webServer>

部署后查看站点根目录下logs文件夹中的日志文件，获取精准错误原因。

2. 核对API调用相关配置变更 #

由于是新发布后出现问题，重点排查发布带来的配置变动：

• 确认WebApp中API的基础地址是否正确，比如是否误将测试环境地址带入生产环境。
• 检查API调用的认证凭据（密钥、Token等）是否过期或未同步到Azure，可对比本地开发环境的appsettings.json与Azure门户配置 > 应用程序设置中的对应项。
• 直接用Postman等工具调用API地址，验证API服务本身是否正常可用。

3. 验证.NET运行时环境配置 #

• 在Azure门户WebApp的配置 > 常规设置中，确认.NET版本设置为.NET 7 (STS)，运行栈选择ASP.NET Core 7。
• 检查部署包是否包含所有依赖DLL，若有新增NuGet包，确认Visual Studio发布时是否将其正确打包；可尝试选择自包含框架模式发布，避免运行环境依赖缺失。

4. 检查网络与文件权限 #

• 若API部署在内部VNet中，确认WebApp已加入对应VNet，且网络安全组规则允许两者通信。
• 确认WebApp文件系统权限正常，wwwroot目录下的文件和配置可被应用进程读取（Azure默认权限通常无问题，但自定义路径需额外确认）。

5. 排查IIS相关配置兼容性 #

• 确认.NET Extensibility Feature已启用：在Azure门户WebApp的配置 > 扩展中检查是否安装对应.NET扩展，或通过Azure CLI执行：

az webapp config set --name <your-webapp-name> --resource-group <your-resource-group> --net-framework-version v7.0

• 尝试切换web.config中的ASP.NET Core托管模式（inprocess/outofprocess），部分场景下模式切换可解决兼容性问题。

6. 回滚版本对比差异 #

若以上步骤未定位问题，可将WebApp回滚到之前正常运行的版本，对比两个版本的代码、配置文件差异，锁定引发问题的具体变更点。

内容的提问来源于stack exchange，提问作者André Tonini