.NET 8 Blazor带字符串参数导航F5刷新/粘贴URL报404问题

1. 配置服务器SPA回退路由 #

Blazor属于单页应用（SPA），刷新或直接粘贴URL访问时，浏览器会直接向服务器请求该路由对应的资源，但服务器默认没有匹配的物理文件或路由规则，因此返回404。需要在服务器端配置回退规则，让所有路由请求转向Blazor的入口文件：

针对Blazor WebAssembly（托管模式） #

在Program.cs中添加核心配置：

app.MapRazorPages();
app.MapControllers();
app.MapFallbackToFile("index.html"); // 所有路由请求回退到Blazor入口文件

针对Blazor Server #

在Program.cs中确保已有以下配置：

app.MapBlazorHub();
app.MapFallbackToPage("/_Host"); // 路由请求回退到Blazor的Host页面

2. 添加路由参数约束处理特殊字符 #

你的实例ID包含.（点号），ASP.NET Core路由默认会将点号后的内容识别为文件扩展名，导致路由匹配失败。需要在页面路由中添加正则约束，明确允许参数包含特殊字符：

修改页面的@page指令：

@page "/recipeInstanceDetail/{InstaceId:regex(^[a-zA-Z0-9\\-._]+$)}"

该正则约束允许参数包含字母、数字、减号、点号和下划线，完全匹配你的实例ID格式。

3. 检查参数名拼写（可选但关键） #

注意到你的参数名是InstaceId（缺少字母n，正确应为InstanceId），虽然你提到其他页面正常，但拼写不一致可能导致参数绑定异常。建议统一参数名：

页面指令修改为：

@page "/recipeInstanceDetail/{InstanceId:regex(^[a-zA-Z0-9\\-._]+$)}"

对应的代码文件中同步修改：

[Parameter]
public string InstanceId { get; set; }

4. 优化导航时的参数编码 #

导航时建议对参数进行编码而非解码，确保特殊字符被正确处理：

var encodedInstanceId = Uri.EscapeDataString(MyStringValue);
NavigationManager.NavigateTo($"/recipeInstanceDetail/{encodedInstanceId}");

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