PAYATHON 2026

本地 API 为何缺少 Access-Control-Allow-Origin 响应头?

排障赵师傅

需要在 API 端允许前端的实际来源 https://localhost:7000,并统一 CORS 策略名称。当前配置有两处问题:

  • 注册的策略名是 AllowSpecificOrigin,使用时却写成了 AllowLocalFrontend。
  • WithOrigins("http://192.168.1.169") 与浏览器发送的来源 https://localhost:7000 不匹配。

即使所有服务都在本地运行,也需要遵守浏览器的同源策略。HTTPS 页面访问 HTTP API 还可能受到混合内容限制,修正 CORS 后仍需检查浏览器是否报告了其他拦截原因。

为什么 MAUI 能调用,浏览器却失败?

浏览器通过协议、主机和端口判断两个地址是否同源:

项目前端页面API
协议httpshttp
主机localhost192.168.X.X
端口70005000

这两个地址不同源,即使运行在同一台电脑上也一样。WithOrigins(...) 应填写发起请求的页面来源,即 https://localhost:7000。来源只包含协议、主机和端口,不包含页面路径,末尾也不要添加 /。ASP.NET Core CORS 文档

MAUI 通过原生 HttpClient 发出的请求不受浏览器 CORS 检查约束,所以 MAUI 能调用 API,并不能说明 CORS 配置正确。SQL Server 位于 API 后面,不参与浏览器与 API 之间的 CORS 检查。

如何修改 Program.cs?

保留现有的服务注册,用同一个常量注册和启用策略:

using AzureNotificationDemo.Hubs;
using AzureNotificationDemo.Services;

var builder = WebApplication.CreateBuilder(args);

const string CorsPolicyName = "AllowLocalFrontend";

builder.Services.AddSignalR();
builder.Services.AddHttpClient<DatabaseService>();
builder.Services.AddSingleton<NotificationService>();
builder.Services.AddControllers();

builder.Services.AddCors(options =>
{
    options.AddPolicy(CorsPolicyName, policy =>
    {
        policy
            .WithOrigins("https://localhost:7000")
            .AllowAnyHeader()
            .AllowAnyMethod();
    });
});

var app = builder.Build();

app.UseStaticFiles();

app.UseRouting();

app.UseCors(CorsPolicyName);

app.UseAuthorization();

app.MapControllers();
app.MapHub<DatabaseHub>("/databaseHub");

var dbService = app.Services.GetRequiredService<DatabaseService>();
_ = Task.Run(() => dbService.PollForUpdates());

app.Run();

UseCors(CorsPolicyName) 会统一应用策略,控制器直接通过 app.MapControllers() 映射,无需重复调用 RequireCors(...)。

UseCors 应放在 UseRouting 之后、UseAuthorization 之前。原代码的顺序正确,只需修正策略名称和允许的来源。ASP.NET Core 命名策略与中间件配置

题目中的 fetch 没有要求携带跨源 Cookie,因此示例省略了 AllowCredentials()。如果使用 Cookie 身份验证,通常还需要在服务端添加:

// 添加到服务端的策略配置链中
.AllowCredentials()

并在前端请求选项中设置:

credentials: "include"

Cookie 能否发送还取决于 SameSite、Secure 等属性和浏览器策略。启用凭据时,应明确指定允许的来源,不能同时使用 AllowAnyOrigin() 和 AllowCredentials()。ASP.NET Core 凭据配置

为什么浏览器会先发送 OPTIONS?

请求设置了:

headers: { "Content-Type": "application/json" }

application/json 不属于 CORS 免预检的 Content-Type。在没有可复用的预检缓存时,浏览器会先发送类似的请求:

OPTIONS /api/response HTTP/1.1
Host: 192.168.X.X:5000
Origin: https://localhost:7000
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type

API 需要在响应中允许该来源、方法和请求头,浏览器才会继续发送 POST。预检不通过,实际的 POST 就不会发出。Fetch 标准:CORS 协议

按前面的方式配置全局 CORS 中间件后,ASP.NET Core 会处理符合策略的预检请求,一般无需专门编写 OPTIONS 控制器。ASP.NET Core 预检请求说明

Access-Control-Allow-Origin 应由 API 在响应中返回,不要把它添加到 fetch 的请求头里。mode: "no-cors" 也无法解决这里的 JSON API 调用问题:它会限制请求,使 JavaScript 无法读取正常的响应状态和内容。Fetch 标准

如何确认配置已经生效?

重启 API,在浏览器开发者工具的 Network 面板中检查 OPTIONS /api/response:

  • 请求头中的 Origin 是否为 https://localhost:7000。
  • 响应头是否包含 Access-Control-Allow-Origin: https://localhost:7000。
  • 是否允许 POST 方法和 content-type 请求头。
  • 响应是否出现重定向、401、403、404 或服务器错误。

也可以用以下命令检查服务端的预检响应,执行前将 IP 替换为实际地址:

curl -i -X OPTIONS "http://192.168.X.X:5000/api/response" \
  -H "Origin: https://localhost:7000" \
  -H "Access-Control-Request-Method: POST" \
  -H "Access-Control-Request-Headers: content-type"

符合上述策略的响应应包含类似内容,方法和请求头的排列可能不同:

Access-Control-Allow-Origin: https://localhost:7000
Access-Control-Allow-Methods: POST
Access-Control-Allow-Headers: content-type

curl 不执行浏览器的安全检查,只能用来查看 API 返回了什么,仍需在浏览器中实际验证。

如果预检被重定向到 HTTPS,应让前端直接请求最终的 HTTPS 地址。如果返回认证错误,则检查是否有代理或认证组件在 CORS 中间件之前拦截了 OPTIONS。

HTTPS 页面调用 HTTP API 还要注意什么?

题目中的请求是:

https://localhost:7000
        ↓
http://192.168.X.X:5000

即使 CORS 配置正确,浏览器仍可能因混合内容或本地网络访问规则拦截请求。具体行为取决于浏览器及其配置。例如,Chrome 对符合条件且经过本地网络访问权限控制的请求提供了混合内容豁免,因此这个地址组合并非在所有浏览器中都会失败。Chrome 本地网络访问说明

开发环境中,以下做法在兼容性上更稳妥:

  • 为 API 配置 HTTPS,使用浏览器信任且与访问主机名或 IP 匹配的证书,并直接请求其 HTTPS 地址。
  • 让前端通过同源服务代理 API 请求。浏览器请求 https://localhost:7000/api/response,由服务端转发到局域网 HTTP API。

如果继续直接访问该 HTTP 地址,修复 CORS 策略后,还需查看控制台是否出现 Mixed Content 或本地网络权限错误,并据此继续排查。增加 CORS 响应头无法解除这些限制。

备注:内容仅供参考。