如何调试部署在Azure上的ASP.NET Web API服务器端执行问题？

一、先拿到具体的错误详情 #

• 打开Azure门户的App Service，进入「监控」>「日志流」，实时查看请求处理时的完整报错日志，这能直接看到代码抛出的异常信息。
• 修改web.config开启详细错误输出，把泛泛的500换成具体报错：在<system.webServer>节点下添加以下配置：

<httpErrors errorMode="Detailed" />
<asp scriptErrorSentToBrowser="true" />

部署后再调用接口，浏览器会返回具体的异常堆栈，直接定位代码问题。

二、重点排查第三方DLL相关问题 #

因为测试接口正常，问题肯定出在调用第三方DLL的业务逻辑上：

• 确认DLL是否部署到位：用Azure Kudu工具（门户>开发工具>高级工具>Go）进入「站点>wwwroot」，检查第三方DLL是否存在，版本和本地完全一致。
• 权限检查：Azure App Service的运行账户默认是IIS APPPOOL\DefaultAppPool，需要给这个账户赋予DLL所在目录的读取权限。可以在Kudu的调试控制台执行命令：

icacls "D:\home\site\wwwroot\你的DLL所在路径" /grant "IIS APPPOOL\DefaultAppPool":R

• 依赖项缺失检查：有些第三方DLL依赖原生组件（比如VC++运行库），本地可能装了但Azure环境没有。用Dependency Walker工具本地分析DLL的依赖项，把缺失的依赖文件一起部署到站点目录，或者通过Azure启动任务安装对应的组件。

三、排查配置文件与路径问题 #

• 校验web.config有效性：在Kudu的调试控制台运行dotnet validate web.config（.NET Core/.NET 5+），或者直接查看配置节点是否有语法错误、缺失必要的配置项。
• 路径适配：如果业务代码里用了本地绝对路径（比如文件读写），Azure的路径结构和本地不同，要改成相对路径或者Azure的标准路径（比如D:\home\site\wwwroot\files）。

四、确认.NET运行环境匹配 #

• 检查.NET版本：在Azure门户「配置」>「常规设置」里查看.NET Runtime版本，必须和本地开发环境的版本完全一致（比如本地用.NET 6，Azure也得选.NET 6）。
• 启用.NET Extensibility Feature（仅针对.NET Framework）：如果是传统.NET Framework项目，确保Azure App Service已启用该功能，可在门户「配置」>「常规设置」的平台选项里确认，或者通过Kudu的站点扩展查看。

五、本地模拟Azure环境复现问题 #

• 用Azure App Service本地模拟器运行代码，模拟Azure的运行环境，看是否能复现500错误，这样能快速定位环境差异导致的问题。
• 对比环境变量：在Azure门户「配置」>「应用程序设置」里导出所有环境变量，和本地的对比，确保数据库连接字符串、第三方服务密钥等配置完全一致。

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