Blazor带加密Token的外部邀请链接跳转404问题排查

针对用户点击邮件邀请链接后Blazor返回404的问题，以下是常见原因及对应解决方法：

1. Token含URL特殊字符导致路由解析失败 #

加密生成的Token通常包含+、/、=等URL保留字符，若生成邮件链接时未对Token做URL编码，浏览器点击链接会自动解码这些字符，导致路由参数与定义不匹配，触发404。

解决方法：
生成链接时对Token进行URL编码，确保特殊字符被转义：

var encodedToken = Uri.EscapeDataString(yourEncryptedToken);
var invitationLink = $"https://yourapp.com/authentication/client/invitation/{encodedToken}";

2. Blazor路由未配置参数通配约束 #

默认情况下，Blazor路由参数不匹配包含斜杠（/）的字符，而加密Token可能包含斜杠，导致路由无法匹配目标页面。

解决方法：
修改页面路由定义，添加通配约束以支持含斜杠的Token：

// 方式1：用通配符*捕获所有字符（包括斜杠）
@page "/authentication/client/invitation/{token*}"

// 方式2：用正则表达式允许任意字符
@page "/authentication/client/invitation/{token:regex(.*)}"

3. 服务器端Fallback路由配置缺失 #

若使用Blazor Web App（尤其是InteractiveAuto或Server渲染模式），服务器需将所有Blazor路由请求转发到index.html，否则服务器会因找不到对应物理文件返回404。

解决方法：
在Program.cs中确认已配置正确的Fallback路由：

// Blazor Web App托管模式配置示例
app.MapRazorComponents<App>()
    .AddInteractiveWebAssemblyRenderMode()
    .AddInteractiveServerRenderMode()
    .AddAdditionalAssemblies(typeof(Client._Imports).Assembly);

// 确保添加Fallback路由
app.MapFallbackToFile("index.html");

4. 邮件链接的Token参数未正确拼接 #

检查生成邮件链接的代码，确保Token被正确拼接到URL的{token}位置，避免参数丢失或路径拼写错误。

正确拼接示例：

var encryptedToken = await clientDataBroker.GenerateInvitationTokenAsync(userInfo, tenantId);
var encodedToken = Uri.EscapeDataString(encryptedToken);
var invitationUrl = $"{appBaseUrl}/authentication/client/invitation/{encodedToken}";

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