SignalR客户端启动Hub连接时返回405 Method Not Allowed错误求助

针对WinForm客户端连接SignalR Hub时抛出405错误的问题，以下是针对性的排查和解决方法：

1. 核对服务器端SignalR路由与CORS配置顺序 #

SignalR 2.x基于OWIN，配置顺序至关重要，必须先配置CORS，再映射SignalR路由，否则CORS规则不会生效。示例代码：

public void Configuration(IAppBuilder app)
{
    // 先配置CORS
    app.UseCors(CorsOptions.AllowAll);
    // 再映射SignalR全局路由
    app.MapSignalR();
}

同时确认客户端连接的URL是SignalR的全局路由（默认是/signalr），而非直接指向Hub类名。

2. 细化CORS配置适配SignalR需求 #

SignalR需要使用Microsoft.Owin.Cors包（而非ASP.NET Core原生CORS），确保已安装该包，并配置允许所有HTTP方法、请求头，必要时开启凭证支持：

app.UseCors(new CorsOptions
{
    PolicyProvider = new CorsPolicyProvider
    {
        PolicyResolver = context => Task.FromResult(new CorsPolicy
        {
            AllowAnyHeader = true,
            AllowAnyMethod = true,
            AllowAnyOrigin = true,
            SupportsCredentials = true // WinForm客户端若需传递凭证可开启
        })
    }
});

3. 解除服务器端HTTP方法限制 #

Kestrel环境 #

检查Program.cs或Startup类中是否有自定义配置限制了OPTIONS、POST等方法，默认Kestrel允许所有方法，若有拦截规则需移除。

IIS部署环境 #

确保IIS允许SignalR所需的HTTP方法：

1. 打开IIS管理器，进入目标站点的「请求筛选」→「HTTP方法」，确认OPTIONS、POST、GET在允许列表中；
2. 或直接在web.config中添加配置：

<system.webServer>
    <security>
        <requestFiltering>
            <verbs>
                <add verb="OPTIONS" allowed="true" />
                <add verb="POST" allowed="true" />
                <add verb="GET" allowed="true" />
            </verbs>
        </requestFiltering>
    </security>
</system.webServer>

4. 验证客户端连接代码正确性 #

• 确认连接URL与服务器SignalR路由一致，Hub代理名称与服务器Hub类的[HubName]特性匹配（未添加特性则使用类名）：

var connection = new HubConnection("http://your-server-url/signalr");
var hubProxy = connection.CreateHubProxy("YourHubClassName");
// 开启日志排查细节
connection.TraceLevel = TraceLevels.All;
connection.TraceWriter = new StreamWriter("signalr-log.txt"); // 输出到日志文件
await connection.Start();

5. 确保WebSockets传输支持 #

SignalR默认优先使用WebSockets，需在服务器端OWIN配置中提前启用：

app.UseWebSockets();
app.MapSignalR();

若服务器环境不支持WebSockets，SignalR会自动 fallback到其他传输方式，但需确保这些方式的HTTP方法未被限制。

6. 排查自定义中间件拦截 #

暂时禁用服务器端的自定义中间件（如授权、日志拦截器），测试是否能正常连接，排查是否有中间件拦截了SignalR的请求。

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