SignalR Core的Hub内添加Cookie触发响应头已启动报错如何解决

错误原因 #

你遇到的*"The response headers cannot be modified because the response has already started"*报错，本质是SignalR Hub的逻辑执行时，HTTP握手响应已经发送到客户端，响应头处于不可修改状态，而Cookie需要写入响应头中，因此直接在Hub方法内操作Response.Cookies自然会触发错误。 #

可行解决方案 #

方案1：在SignalR握手前通过中间件添加Cookie（推荐，首次连接即可生效） #

在请求进入SignalR Hub处理逻辑前，通过自定义中间件匹配Hub路由，完成Cookie的校验和写入，此时HTTP响应尚未发送，可以正常修改响应头。
.NET 6+ Program.cs代码示例：

// 注意：该中间件必须放在MapHub注册逻辑之前
app.Use(async (context, next) =>
{
    // 替换为你实际使用的Hub路由路径
    if (context.Request.Path.StartsWithSegments("/hubs/yourHubName"))
    {
        if (!context.Request.Cookies.ContainsKey("_a_cookie"))
        {
            context.Response.Cookies.Append("_a_cookie", "1", new CookieOptions
            {
                HttpOnly = true,
                // 可按需配置Secure、SameSite、Expires等属性
            });
        }
    }
    await next();
});

// 后续正常注册Hub即可
app.MapHub<YourHub>("/hubs/yourHubName");

方案2：Hub通知客户端自行写入Cookie #

如果Cookie值依赖Hub内的业务逻辑才能确定，可以在OnConnectedAsync生命周期方法中调用客户端方法，将Cookie参数传递给前端，由前端完成本地写入：
Hub端代码示例：

public override async Task OnConnectedAsync()
{
    var httpContext = Context.GetHttpContext();
    if (!httpContext.Request.Cookies.ContainsKey("_a_cookie"))
    {
        // 调用当前连接对应的客户端SetCookie方法
        await Clients.Caller.SendAsync("SetCookie", "_a_cookie", "1");
    }
    await base.OnConnectedAsync();
}

前端JS SignalR客户端代码示例：

// 监听服务端发送的SetCookie事件
connection.on("SetCookie", (cookieName, cookieValue) => {
    document.cookie = `${cookieName}=${cookieValue}; path=/; SameSite=Lax`;
});

说明：该方案下首次建立SignalR连接时Cookie不会立即生效，下次重连或后续的HTTP请求才会携带该Cookie。

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