.NET中SignalR的CORS配置问题及MAUI接入求助

现有配置的核心问题 #

你的CORS策略仅指定了允许的Origin，但SignalR依赖WebSocket/Server-Sent Events通信，需要额外开放请求头、请求方法，并允许凭证传递，同时管道配置顺序也可能存在疏漏。

修正后的CORS策略配置 #

先清理重复的Origin，补充SignalR必需的CORS选项：

builder.Services.AddCors(options =>
{
    options.AddPolicy("signalr_policy", policy =>
    {
        policy.WithOrigins(
            "https://domain1",
            "https://domain2",
            "https://domain3",
            "https://www.domain1",
            "https://www.domain2",
            "https://www.domain3",
            "https://www.domain4",
            "https://localhost",
            // MAUI开发环境适配
            "http://10.0.2.2", // Android模拟器访问本地后端
            "http://localhost" // iOS模拟器、Windows平台
        )
        .AllowAnyHeader() // 允许SignalR握手所需的自定义头
        .AllowAnyMethod() // 允许GET/POST等握手请求方法
        .AllowCredentials(); // SignalR必须启用，握手过程会携带凭证
    });
});

管道配置顺序调整 #

确保UseCors在正确位置执行（必须在UseRouting之后，UseEndpoints之前）：

app.UseRouting();

// 必须放在UseRouting之后、UseEndpoints之前
app.UseCors("signalr_policy");

app.UseAuthorization();

app.UseEndpoints(endpoints =>
{
    endpoints.MapHub<Services>("/servicesHub"); // 替换为你的Hub实际路由
});

MAUI应用接入注意事项 #

• 开发环境：Android模拟器需用http://10.0.2.2代替localhost（映射本地电脑的localhost）；iOS/Windows平台可直接用localhost或电脑局域网IP。
• 生产环境：如果MAUI应用打包后使用自定义Scheme（如myapp://），需将该Scheme添加到WithOrigins列表中；若使用云托管API，直接添加API的正式域名即可。
• 客户端连接示例：MAUI中SignalR客户端连接代码需匹配后端Hub路由：

var connection = new HubConnectionBuilder()
    .WithUrl("https://your-api-domain/servicesHub")
    .Build();

await connection.StartAsync();

问题排查要点 #

1. 查看浏览器/MAUI调试日志的具体CORS错误信息，确认是Origin不允许还是头/方法限制。
2. 验证客户端请求的Origin是否完全匹配配置中的值（注意协议、域名、端口必须一致）。
3. 生产环境禁止使用AllowAnyOrigin，严格指定允许的Origin列表，避免安全风险。

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