升级至.NET 7后Blazor WASM认证错误修复方案咨询

1. 配置Azure静态站点回退路由 #

Blazor WASM作为单页应用，所有路由都需要指向index.html才能被应用正确处理。升级.NET7后，认证流程的login-failed路径可能没被现有路由规则覆盖，导致返回404：

• 方法1（Azure门户操作）：进入静态站点「配置」→「路由规则」，添加规则：
  • 源路径：/authentication/*
  • 目标路径：/index.html
  • 类型：重写
• 方法2（配置文件方式）：在项目根目录添加/修改staticwebapp.config.json，写入：

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

部署后，这条规则会让所有/authentication开头的路径都指向应用入口，避免404。

2. 清除Azure部署缓存 #

Azure静态站点可能缓存了旧的.NET6时代的资源或路由配置，导致新的.NET7认证逻辑无法生效：

• 在静态站点「概述」页面，找到「清除缓存」选项（部分区域在「高级工具」下），执行全量缓存清除；
• 重新发布项目，确保_framework下的.NET7 runtime文件完全覆盖旧文件。

3. 验证认证提供商的重定向URI #

虽然认证功能正常，但.NET7对OIDC流程的重定向处理有细微调整，需确认认证后台的重定向URI包含相关路径：

• 登录你的认证服务（如Azure AD、Auth0）后台，检查已配置的重定向URI，确保包含https://<你的域名>/authentication/login-callback；
• 无需单独配置login-failed，但要确保该路径能被路由到Blazor应用（即第一步的路由规则生效）。

4. 检查Program.cs中的认证配置 #

升级后确认认证注册代码没有错误配置：

builder.Services.AddOidcAuthentication(options =>
{
    builder.Configuration.Bind("YourAuthConfig", options.ProviderOptions);
    options.ProviderOptions.RedirectUri = "authentication/login-callback";
    options.ProviderOptions.PostLogoutRedirectUri = "/";
    // 不要手动修改login-failed的默认处理路径
});

若使用了混合渲染模式，确保没有因InteractiveServerRenderMode导致的路由冲突，纯WASM项目保持默认配置即可。

5. 排查Azure CDN缓存（若启用） #

如果站点配置了CDN，CDN可能缓存了旧的404响应：

• 进入CDN资源，执行端点全量缓存清除；
• 检查CDN路由规则，确保/authentication/*路径被正确转发到静态站点，而非直接返回404。

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