Blazor Server部署至Apache子目录时遇Connection ID required错误求助

核心问题分析 #

你遇到的Connection ID required错误源于SignalR连接路径不匹配，双路径可访问则是因为未全局统一应用路由前缀。以下是针对性解决方案：

1. 全局统一路由前缀（解决双路径+SignalR连接问题） #

在program.cs中添加UsePathBase配置，让整个应用的路由、静态资源、SignalR Hub自动带上指定前缀，替代仅给MapBlazorHub单独加路径的做法：

var builder = WebApplication.CreateBuilder(args);

// 从配置读取PathBase，默认值设为"/email2db"
var pathBase = builder.Configuration.GetValue<string>("PathBase") ?? "/email2db";

// 注入HttpContextAccessor，供后续base标签动态获取路径
builder.Services.AddHttpContextAccessor();

var app = builder.Build();

// 必须在UseRouting之前调用UsePathBase，全局应用路由前缀
app.UsePathBase(pathBase);

app.UseRouting();

// 移除MapBlazorHub的路径参数，让它自动继承全局PathBase
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

2. 修正App.razor的base标签 #

使用IHttpContextAccessor动态获取当前PathBase，避免硬编码错误，确保与全局配置一致：

@inject IHttpContextAccessor HttpContextAccessor

<!DOCTYPE html>
<html lang="en">
<head>
    ...
    <!-- 动态生成base href，自动处理结尾斜杠 -->
    <base href="@($"{HttpContextAccessor.HttpContext?.Request.PathBase}/")" />
</head>
...

3. 简化launchSettings.json配置 #

将launchUrl改为相对路径，避免重复写域名：

"profiles": {
  "http": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "applicationUrl": "http://localhost:5104",
    "launchUrl": "email2db/",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  },
  ...
}

4. 配置Apache反向代理（关键部署步骤） #

确保Apache正确转发/email2db路径的请求到ASP.NET Core应用，并且支持WebSocket（Blazor Server依赖SignalR的WebSocket传输）：

<VirtualHost *:5401>
    ServerName localhost
    ProxyPreserveHost On

    # 转发普通HTTP请求
    ProxyPass /email2db http://localhost:5104/email2db
    ProxyPassReverse /email2db http://localhost:5104/email2db

    # 专门处理WebSocket请求（Blazor SignalR的Hub路径）
    ProxyPass /email2db/_blazor http://localhost:5104/email2db/_blazor upgrade=websocket
    ProxyPassReverse /email2db/_blazor http://localhost:5104/email2db/_blazor
</VirtualHost>

5. 验证效果 #

• 启动应用后，仅http://localhost:5401/email2db/pages/mypage能正常访问，根路径下的/pages/mypage会返回404，解决双路径问题。
• SignalR连接会自动使用/email2db/_blazor路径，不再出现Connection ID required错误。

关于CORS的说明 #

不需要配置CORS，因为Apache是反向代理，请求在服务器内部转发，不存在跨域场景。

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