Blazor Server配置Front Door后生产环境出现Long Polling及交互失效问题

以下是针对Front Door部署后Blazor Server出现跳转失效、@code块无法执行、blazor.server.js报错问题的具体修复步骤：

• 校验Front Door路径转发规则
  确保Front Door未修改Blazor核心依赖路径的转发逻辑，需排除/_framework/blazor.server.js、/_blazor（SignalR端点）这类路径的URL重写或修改，保留原始路径结构。若设置了路径前缀，需确保前缀完整传递到后端Blazor服务。

• 配置Blazor Base Path（若使用路径前缀）
  如果Front Door为Blazor应用配置了自定义路径前缀（如https://your-frontdoor-domain.com/blazor-app），需在项目中同步配置：

  1. 在Program.cs中添加路径基准配置：

     app.UsePathBase("/blazor-app");
     

  2. 在Pages/_Host.cshtml的<head>标签内添加base标签：

     <base href="/blazor-app/" />
     

• 调整SignalR传输配置
  显式配置SignalR的传输方式，确保WebSocket和长轮询都被支持，适配Front Door的中转特性：
  在Program.cs的Blazor Hub映射中添加：

  app.MapBlazorHub(options =>
  {
      options.Transports = HttpTransportType.WebSockets | HttpTransportType.LongPolling;
  });
  

  同时确认Front Door控制台已启用WebSocket协议，且WAF/防火墙规则未拦截/_blazor路径的WebSocket连接。

• 配置CORS规则（跨域场景）
  若Front Door域名与后端Blazor服务器域名不一致，需添加CORS策略允许Front Door域名访问：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("FrontDoorCors", policy =>
      {
          policy.WithOrigins("https://your-frontdoor-domain.com")
                .AllowAnyHeader()
                .AllowAnyMethod()
                .AllowCredentials();
      });
  });
  app.UseCors("FrontDoorCors");
  

  注意将该配置放在UseRouting之前、UseAuthorization之后。

• 禁用Blazor核心资源的缓存
  在Front Door的缓存规则中，为/_framework/*、/_blazor路径添加排除规则，设置为不缓存，避免旧版本的blazor.server.js或SignalR连接脚本被缓存导致兼容性问题。

• 排查详细错误日志
  启用Blazor的调试日志定位具体问题：
  在Program.cs中添加日志级别配置：

  builder.Logging.SetMinimumLevel(LogLevel.Debug);
  

  同时通过浏览器F12控制台查看blazor.server.js的具体错误栈，确认是连接失败、脚本加载异常还是权限问题。

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