Blazor WASM应用HTML页面链接本地正常，生产服务器无法访问？

问题定位与解决步骤 #

1. 检查路径大小写一致性 #

Azure App Service默认区分文件名和路径大小写，而本地Windows环境不区分。确认wwwroot/Legal/Cookies.html的文件夹名、文件名大小写，和链接中的/Legal/Cookies.html完全一致，比如避免出现本地是cookies.html但链接写Cookies.html的情况。

2. 托管模式下配置静态文件中间件 #

如果你的Blazor WASM是ASP.NET Core托管模式，需确保后端的Program.cs中，静态文件中间件在Blazor路由之前注册：

// 先注册静态文件中间件，确保优先处理静态文件请求
app.UseStaticFiles();

// 再注册Blazor路由
app.MapRazorComponents<App>()
    .AddInteractiveWebAssemblyRenderMode()
    .AddAdditionalAssemblies(typeof(Client._Imports).Assembly);

静态文件中间件默认会处理wwwroot目录下的所有文件（包括子文件夹），无需额外配置即可访问。

3. 适配虚拟目录部署场景 #

如果应用部署在Azure App Service的虚拟目录下（比如https://yourapp.azurewebsites.net/app），需动态获取基础路径避免硬编码错误。通过注入NavigationManager修改链接：

@inject NavigationManager NavManager

<a href="@($"{NavManager.BaseUri}Legal/Cookies.html")" class="b-bar-link" target="_blank">
  Cookies
</a>

这样会自动拼接环境的基础路径，适配本地和生产环境的差异。

4. 验证Azure部署后的文件结构 #

通过Azure Portal进入App Service的高级工具 > Kudu > 调试控制台 > 站点/wwwroot/Legal，确认Cookies.html是否存在且文件名正确。若缺失，可手动上传文件测试，排除发布过程中的文件遗漏问题。

5. 独立模式下配置静态网站路由 #

如果是Blazor WASM独立模式（无ASP.NET Core后端），部署到Azure静态Web Apps时，需在wwwroot/staticwebapp.config.json中添加路由规则，优先匹配静态文件：

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

该配置会让静态文件请求直接返回对应资源，而非重定向到Blazor的index.html。

Blazor WASM混合使用静态文件说明 #

• 所有静态文件需放在wwwroot目录下，这是Blazor WASM默认的静态文件根目录。
• 托管模式下，依赖ASP.NET Core的静态文件中间件提供文件访问，确保中间件注册顺序正确即可。
• 独立模式下，需依赖托管服务（如Azure静态Web Apps）的路由配置，避免SPA路由规则拦截静态文件请求。

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