用curl模拟OPTIONS预检请求可验证网关是否正确响应:状态码须为204或200,响应头必须含Access-Control-Allow-Origin(凭据请求不可为*),且响应体为空;还需测试带凭据真实请求、Origin头透传、非法域名拦截及避免下游重复配置CORS。

用 curl 模拟 OPTIONS 预检请求验证网关是否拦截
网关若未正确处理 OPTIONS,前端根本发不出后续请求——所以第一步必须手动确认预检是否被网关响应,而不是转发给下游服务。
执行以下命令(替换 https://gateway.example.com/api/users 为你的真实地址):
curl -X OPTIONS \ -H "Origin: https://app.example.com" \ -H "Access-Control-Request-Method: POST" \ -H "Access-Control-Request-Headers: Content-Type,Authorization" \ -I https://gateway.example.com/api/users
关键看三件事:
- 状态码必须是
204 No Content或200 OK(不能是404、405或502) - 响应头中必须包含
Access-Control-Allow-Origin,且值不能是*(如果带凭据) - 响应体必须为空(
curl -I不显示 body,可去掉-I再试一次确认无 body)
检查带凭据请求是否真正通路
很多配置在预检阶段看似正常,但真实请求仍失败——往往是因为 Access-Control-Allow-Credentials: "true" 和 Access-Control-Allow-Origin: "*" 同时存在,浏览器会静默拒绝,连控制台都不报错。
立即学习“go语言免费学习笔记(深入)”;
用 curl 发起一个带凭据的真实请求:
curl -X POST \
-H "Origin: https://app.example.com" \
-H "Content-Type: application/json" \
-H "Cookie: session=abc123" \
--cookie "session=abc123" \
-d '{"name":"test"}' \
-v https://gateway.example.com/api/users重点观察响应头:
-
Access-Control-Allow-Origin必须与请求中的Origin完全一致(如https://app.example.com),不能是* - 必须有
Access-Control-Allow-Credentials: "true"(注意是字符串"true",不是布尔值) - 必须有
Vary: Origin(缺这个会导致 CDN 或代理缓存错误的 CORS 响应)
确认网关是否透传 Origin 头给下游
有些网关(如 Nginx 默认配置、某些自研 Go 网关)会在转发时丢弃或重写 Origin 头,导致下游服务白名单校验失败。
临时在下游服务加一行日志(以 Gin 为例):
router.Use(func(c *gin.Context) {
log.Printf("Received Origin header: %s", c.Request.Header.Get("Origin"))
c.Next()
})再用 curl 发起预检或真实请求,查看日志输出是否为预期域名。常见问题包括:
- Nginx 中没加
proxy_set_header Origin $http_origin; - Go 网关在
RoundTrip前没显式拷贝r.Header.Set("Origin", r.Header.Get("Origin")) - Traefik 的 CORS 中间件没启用,或
originList配置为空导致 fallback 到 deny-all
动态白名单下测试非标域名是否被拒绝
生产环境通常用 handlers.AllowedOriginsFunc 或类似机制做域名白名单校验。这时候要验证“非法 Origin”是否真被拦住,而不是漏放。
故意用一个不在白名单里的域名发起预检:
curl -X OPTIONS \ -H "Origin: https://evil.com" \ -H "Access-Control-Request-Method: GET" \ -I https://gateway.example.com/api/users
预期结果是:
- 响应头中 **没有**
Access-Control-Allow-Origin - 状态码可以是
204(网关主动响应)或403(由白名单逻辑返回),但绝不能返回Access-Control-Allow-Origin: https://evil.com - 如果返回了该头,说明白名单逻辑未生效,或中间件挂载顺序错误(比如 CORS 中间件在路由匹配之后才执行)
最易被忽略的是:网关层做了白名单,但某个下游服务又自己加了一套 CORS 中间件,且允许 * ——这时浏览器实际收到的是下游写的头,网关配置形同虚设。


















