部署Umbraco 13应用至Azure App Service时的前端显示异常问题

核心判断 #

后台能正常访问且内容与本地一致，说明数据库连接、后台服务、应用程序池均正常，问题集中在前端路由匹配、内容发布状态、静态资源部署或宿主配置上，以下是具体排查步骤：

• 检查首页内容发布状态
  Umbraco前端内容仅对已发布节点可见，即使本地已发布，若数据库同步后首页节点处于「草稿（Draft）」状态，前台无法加载。进入后台/umbraco#/content，找到首页节点，确认右上角状态为「已发布（Published）」，若为草稿，点击「发布」按钮完成发布。

• 验证主机名绑定配置
  Umbraco依赖主机名映射来路由请求到对应内容节点：

  1. 进入后台「设置（Settings）」→「主机名（Hostnames）」
  2. 确认已为Azure App Service的URL（如xxx.azurewebsites.net）添加主机名，并关联到首页节点
  3. 若未配置，Umbraco无法识别当前域名对应的内容节点，会返回Azure默认页面

• 排查静态资源部署完整性
  前端页面依赖wwwroot下的静态资源（css、js、media等），需确认：

  1. 通过Kudu工具访问https://<app-name>.scm.azurewebsites.net，进入站点wwwroot目录，检查静态文件是否与本地一致
  2. 在Azure门户的应用服务「配置」→「常规设置」中，确认「静态文件」选项处于开启状态

• 查看应用日志定位路由错误
  实时日志能直接暴露路由或加载问题：

  1. 在Azure门户进入应用服务「监控」→「日志流」，查看是否有404或路由匹配失败的错误信息
  2. 通过Kudu的「调试控制台」→「CMD」，进入LogFiles目录，查看Umbraco日志文件（wwwroot/logs下的.txt文件），排查内容加载时的异常

• 检查Umbraco路由与环境配置

  1. 确认本地的路由配置（Program.cs或Startup.cs中的路由规则）已正确部署，Umbraco默认启用内容路由，若有自定义路由需检查是否拦截了首页请求
  2. 查看应用设置中的Umbraco:CMS:WebRouting:DisableRedirectUnmatchedUrls，若设为true，未匹配的路由不会重定向到Umbraco，需改为false
  3. 确认ASPNETCORE_ENVIRONMENT设置为Production，Umbraco在生产环境下的静态资源缓存、路由规则与开发环境有差异

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