Blazor WASM根页路由参数在Azure Static Web Apps直接访问报404

这是Azure Static Web Apps默认静态托管规则和SPA应用路由机制不匹配导致的，和你写的Blazor路由逻辑没有直接关系：

• Blazor WASM是纯前端单页应用，所有路由匹配、页面渲染逻辑都在浏览器端完成：当你从根页面点击客户链接跳转时，浏览器不会向服务器发送/customer路径的文件请求，只是修改地址栏URL，由已经加载完成的Blazor路由系统解析路径、渲染对应内容，所以这个场景完全正常。
• 当你直接在地址栏输入/customer访问时，浏览器会先向Azure的托管服务器请求该路径对应的资源。Azure Static Web Apps默认只会返回站点下实际存在的静态文件，找不到/customer路径对应的实体文件时就会直接返回404，根本不会把请求交给Blazor处理。
• 本地开发环境之所以正常，是因为Blazor内置的开发服务器默认配置了SPA回退规则：所有找不到对应文件的路径请求，都会统一返回根目录的index.html，Blazor启动后就能正常解析路由。

你不需要修改现有路由结构改成/c/customer的形式，只要补全Azure侧的路由回退配置就能完全保留现有实现。

• 在Blazor项目的wwwroot目录下新建名为staticwebapp.config.json的配置文件（Azure Static Web Apps会自动识别这个文件作为站点路由、权限等规则的配置源）
• 写入如下配置：

{
  "navigationFallback": {
    "rewrite": "/index.html",
    "exclude": [
      "/_framework/*",
      "/css/*",
      "/js/*",
      "*.{png,jpg,gif,svg,ico,webp,woff,woff2,ttf}",
      "/api/*"
    ]
  }
}

这个配置的作用是：所有未匹配到实际静态文件、且不在排除列表内的请求，统一重写返回根目录的index.html，浏览器加载完Blazor运行时后会自动解析当前URL的路径，匹配你写的路由规则渲染客户详情。排除列表内的框架文件、静态资源、托管API接口会正常响应，不会走回退逻辑。

• 把这个文件随项目一起发布到Azure Static Web Apps即可，部署完成后直接访问子路径就不会再返回404。

你的Blazor代码里有几个会导致逻辑异常的小问题，需要同步修复：

• 路由参数名不匹配：路由模板@page "/{CustomerURL}"定义的参数名为CustomerURL，但你标记[Parameter]的属性名为Customer，Blazor路由参数按名称严格绑定，这会导致你永远拿不到路径里的客户标识，参数始终为null。需要将参数定义修改为和路由模板一致：

[Parameter]
public string? CustomerURL { get; set; }

• 异步方法未等待、API调用重复：你同时在OnInitializedAsync和SetParametersAsync中写了客户查询逻辑，会导致重复发起API请求；且APICall()是异步方法，没有加await会导致对象还没查询完成就渲染页面。直接删掉OnInitializedAsync里的查询逻辑，只保留SetParametersAsync中的逻辑并补充空值判断、await关键字：

public async override Task SetParametersAsync(ParameterView parameters)
{
    await base.SetParametersAsync(parameters);
    customer = null;
    if (!string.IsNullOrEmpty(CustomerURL))
    {
        customer = await APICall();
    }
}

• 语法错误：页面模板中string.isNullOrEmpty(CustomerURL)存在两个问题，一是方法名首字母需要大写（C#静态方法名是Pascal大小写，应为IsNullOrEmpty），二是缺少右括号，修正后为@if(string.IsNullOrEmpty(CustomerURL))。

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