ASP.NET Core应用部署到Azure后访问显示空白页问题求助

对应症状匹配 #

静态资源（wwwroot下文件）可正常访问，CI/CD构建部署流程显示成功，本地运行全功能正常，访问MVC路由返回空白页，默认日志无报错，可按以下优先级逐一排查：

• 运行时版本匹配校验
  首先核对项目目标框架版本与Azure应用服务的运行时配置完全一致：打开项目文件查看TargetFramework配置值，进入Azure应用服务-配置-常规设置页，将.NET版本切换为与项目目标框架完全对应的正式版本，禁止选择"默认堆栈"或版本号不匹配的选项。版本不匹配时会出现静态文件中间件正常加载、MVC管道初始化失败返回空响应的情况，这类启动级错误默认不会被常规日志捕获。
• 开启详细错误捕获定位具体异常
  临时调整项目启动配置，强制加载开发异常页：在启动配置文件（.NET 6+为Program.cs，低版本为Startup.cs）的请求管道最前端添加app.UseDeveloperExceptionPage();，不做环境判断。同时进入Azure应用服务-配置-应用设置，新增两项配置：
  • 键 ASPNETCORE_ENVIRONMENT，值 Development
  • 键 ASPNETCORE_DETAILEDERRORS，值 true
    保存配置后重启应用，再次访问根路径即可直接展示具体的异常堆栈，无需再盲查问题。
• 校验Razor视图发布完整性
  本地调试时VS会动态加载视图文件，不会暴露发布配置问题，但CI/CD流程发布时如果项目未开启Razor预编译，容易出现视图文件/视图编译产物未被打包到发布包的情况，最终导致MVC路由找不到对应视图返回空响应。在项目.csproj文件中添加如下配置：

  <PropertyGroup>
    <MvcRazorCompileOnPublish>true</MvcRazorCompileOnPublish>
  </PropertyGroup>
  

  提交代码触发重新部署后，可进入Kudu控制台查看site/wwwroot目录，确认存在项目名.Views.dll文件即可排除视图缺失问题。
• 检查请求中间件顺序
  Azure应用服务托管时会走IIS反向代理，对中间件顺序的容错率比本地Kestrel直接运行更低。确认请求管道配置顺序符合规范：静态文件中间件之后必须依次配置路由、鉴权授权、控制器路由映射，参考正确顺序：

  app.UseHttpsRedirection();
  app.UseStaticFiles();
  app.UseRouting();
  app.UseAuthorization();
  app.MapControllerRoute(
      name: "default",
      pattern: "{controller=Home}/{action=Index}/{id?}");
  app.Run();
  

  如果路由映射被放到了静态文件中间件之前，或者鉴权配置顺序错误，会出现MVC管道不执行、返回空响应的问题。
• 正确查看应用日志
  默认配置下应用服务不会主动输出详细日志，进入应用服务-监视-应用服务日志页，打开文件系统类型的应用程序日志，日志级别设置为详细，等待5分钟后再进入Kudu控制台，打开LogFiles/Application目录即可查看所有请求处理、启动阶段的详细错误日志，不要只查看Kudu根目录的默认部署日志。

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