Docker-Compose+Nginx部署Blazor应用SignalR连接405错误排查

405错误的核心原因是Nginx未正确配置以支持SignalR的通信需求，开发环境正常说明代码本身无问题，重点排查Nginx反向代理配置，同时验证相关部署细节：

1. 修正Nginx的HTTP方法允许配置 #

SignalR在协商阶段会使用GET、POST、OPTIONS方法，若Nginx禁止了这些方法，就会返回405。在对应SignalR路径的location块中添加方法允许规则：

location /tacticsHub {
    # 允许SignalR必需的HTTP方法
    allow_methods GET POST OPTIONS;
    # 其余配置...
}

2. 添加WebSocket升级支持 #

SignalR优先使用WebSocket传输，Nginx需要正确处理WebSocket的升级请求，否则会导致协商失败触发405。在location块中添加以下配置：

location /tacticsHub {
    # WebSocket升级配置
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    # 延长连接超时，适配SignalR长连接特性
    proxy_read_timeout 300s;
    proxy_connect_timeout 75s;
    # 其余反向代理配置...
}

3. 验证Nginx反向代理路径与SignalR映射一致 #

确保Nginx的location路径与Blazor应用中SignalR Hub的映射路径完全匹配：

• 若Program.cs中映射的是app.MapHub<TacticsHub>("/tacticsHub");，则Nginx的location必须为/tacticsHub，不能有路径重写或拼写错误。

4. 完整Nginx配置示例 #

server {
    listen 80;
    server_name your-domain.com;

    # SignalR Hub专属反向代理配置
    location /tacticsHub {
        allow_methods GET POST OPTIONS;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://blazor-app:80; # 对应Docker-Compose中应用容器的名称和端口
        proxy_read_timeout 300s;
        proxy_connect_timeout 75s;
    }

    # 应用其他路径的反向代理配置
    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://blazor-app:80;
    }
}

5. 后续验证步骤 #

• 重启Nginx使配置生效：sudo nginx -s reload
• 查看Nginx错误日志排查问题：sudo tail -f /var/log/nginx/error.log
• 确认Docker-Compose中应用容器的端口映射正确，Nginx的proxy_pass指向容器的正确端口（比如应用容器暴露的是80，则proxy_pass http://blazor-app:80）
• 验证Blazor客户端的HubConnection路径正确，使用NavigationManager.BaseUri拼接Hub路径，避免硬编码localhost地址：

  public HubConnectionService(NavigationManager navManager)
  {
      HubConnection = new HubConnectionBuilder()
          .WithUrl($"{navManager.BaseUri}tacticsHub")
          .Build();
  }
  

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