WebAssembly Blazor部署至Azure Linux后显示内容等待提示的问题

排查步骤 #

1. 确认部署文件是否在正确目录 #

Linux Azure App Service的默认静态文件根目录是/home/site/wwwroot，通过Kudu（SCM站点，https://[你的应用名].scm.azurewebsites.net）的文件管理器查看该目录：

• 确认是否存在Blazor WASM的核心文件：index.html、_framework文件夹、css/js等静态资源
• 如果文件不在此目录，检查Github Actions的部署脚本是否指定了正确的目标路径，或者Zip包的结构是否正确（解压后直接包含这些文件，而非嵌套在子文件夹里）

2. 检查应用服务运行栈配置 #

在Azure门户进入应用服务的配置 > 常规设置：

• 若为独立Blazor WASM（无ASP.NET Core托管），确保运行时堆栈选择静态网站，或对应版本的.NET（如.NET 7/8）
• 若为托管式Blazor WASM，需选择匹配项目的.NET运行时版本，且部署包需包含服务器端程序文件

3. 查看详细部署日志 #

即使部署摘要显示无错误，仍需检查Kudu的详细部署日志：

• 进入SCM站点的部署页面，点击对应部署记录的日志链接
• 确认Zip包是否成功解压至/home/site/wwwroot，无解压失败、权限拒绝等报错
• 可在SCM的控制台执行命令验证：

  ls -la /home/site/wwwroot
  

  查看文件列表是否完整

4. 修复静态文件路由与权限 #

• 路由配置：在wwwroot目录添加staticwebapp.config.json文件，确保前端路由正常：

  {
    "routes": [
      {
        "route": "/*",
        "serve": "/index.html",
        "statusCode": 200
      }
    ]
  }
  

• 文件权限：在SCM控制台执行命令赋予文件可读权限：

  chmod -R 755 /home/site/wwwroot
  

5. 重启应用服务 #

在Azure门户的应用服务概述页面，点击重启按钮，确保部署的配置与文件生效

内容的提问来源于stack exchange，提问作者Parker Harris Emerson