Azure Web应用部署异常：本地正常生产环境启动失败（ANCM错误）

我之前从OutOfProcess切换到InProcess模式时，在Azure Web App上也碰到过完全一样的问题——本地跑着毫无问题，一部署就报500.30，日志还空得离谱。结合踩过的坑，给你几个针对性的排查方向：

• 先确认Runtime版本完全匹配
  别小看这个，Azure Web App默认的Runtime版本可能和你本地开发环境不一致。比如你本地用的是.NET 6.0.12，但Azure上选的是.NET 6.0.x的旧版本，就可能导致启动失败。去Azure门户的Web App → 配置 → 常规设置里，找到「Stack settings」，确保Runtime版本、SDK版本和你发布的应用完全对齐。

• 强制开启详细的启动日志
  你说日志文件夹为空，大概率是默认日志配置没生效。可以手动修改web.config（InProcess模式下发布时会自动生成，你可以在本地项目里添加或者发布后通过Kudu修改），添加/stdout日志配置：

  <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" 
              stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" 
              hostingModel="InProcess" />
  

  然后去Kudu控制台（https://<你的应用名>.scm.azurewebsites.net/）的「Debug Console」里查看site/wwwroot/logs文件夹，这里面的日志会详细记录启动时的错误——比如某个依赖找不到、配置文件加载失败、数据库连接字符串错误等，我当时就是在这里查到了某个第三方组件不兼容InProcess的问题。

• 检查Azure应用设置的覆盖问题
  虽然你说配置文件和上一版本一致，但Azure的「应用设置」会直接覆盖appsettings.json里的内容。比如你本地用的是测试环境的连接字符串，但Azure上的应用设置里配置了生产环境的旧字符串，就会导致启动时数据库连接失败。去Web App → 配置 → 应用设置里，仔细核对所有配置项，尤其是ASPNETCORE_ENVIRONMENT是否设为了Production，有没有新增的冲突配置。

• 捕获启动时的全局异常
  InProcess模式下，应用启动时的异常有时候不会直接抛到前端页面。你可以在Program.cs里添加日志配置，把启动时的所有日志都输出到Azure诊断日志：

  var builder = WebApplication.CreateBuilder(args);
  
  // 添加Azure日志支持
  builder.Logging.AddAzureWebAppDiagnostics();
  builder.Logging.SetMinimumLevel(LogLevel.Trace);
  
  // 其他配置...
  

  然后去Azure门户的Web App → 日志 → 应用日志里查看详细日志，这里能抓到很多stdout日志里没记录的启动异常。

• 清理部署缓存后重新发布
  有时候Azure的部署缓存会残留旧文件，导致冲突。你可以先通过Kudu控制台删除site/wwwroot下的所有文件，然后重新发布应用。如果用了部署槽，建议先清理槽内的旧文件再发布，避免槽交换时出现问题。

• 排查InProcess模式的兼容性问题
  有些在OutOfProcess模式下正常运行的组件，可能不支持InProcess模式——比如某些自定义HttpModule、老旧的第三方库。你可以暂时把web.config里的hostingModel改回OutOfProcess，如果部署后正常运行，那肯定是某个组件和InProcess不兼容，需要逐个排查依赖库。

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