Kratos Gateway 的 CORS 配置必须在 config.yaml 中统一设置,因其作为独立网关进程默认拦截并响应 OPTIONS 预检请求(返回 204),不透传下游服务的 CORS 响应头;allowCredentials: true 时 allowOrigins 禁用 "*",否则浏览器静默拒绝。

Kratos Gateway 的 CORS 配置必须在 config.yaml 中统一设置,不能依赖下游 service 自行加中间件——否则预检请求(OPTIONS)根本到不了后端,浏览器连控制台错误都不会报,静默失败。
为什么只能在网关层配,下游 service 加了也没用
Kratos Gateway 是独立进程,默认已拦截所有 OPTIONS 请求并返回 204,且不透传下游的响应头。即使你在 user service 里用了 gorilla/handlers.CORS() 或自定义中间件,网关也不会把那些 Access-Control-* 头转发给浏览器。你看到的日志里“请求已到达 controller”,只是说明业务逻辑执行了,但浏览器压根没收到 CORS 头。
- 确认你用的是 Kratos 官方
gateway模块(不是手写的 reverse proxy),它的cors中间件默认启用且OptionsPassthrough: false - 不要在 downstream service 的 middleware 里重复加 CORS,否则可能 header 冲突或重复写入
- 若用
gorilla/handlers.CORS()自定义,必须显式设OptionsPassthrough: false并返回http.StatusNoContent
allowCredentials: true 时 allowOrigins 不能写 ["*"]
这是最常踩的坑:一旦开启凭据支持(比如带 Cookie 或 Authorization 头),浏览器会直接丢弃响应,连控制台错误都没有。原因在于 W3C 规范强制要求,Access-Control-Allow-Origin 在 credentials 开启时必须是具体域名,不能是通配符。
- 开发环境可硬编码:
allowOrigins: ["http://localhost:3000", "https://app.example.com"] - 生产环境建议禁用通配符,改用动态白名单:从请求头
Origin提取 host,校验是否在许可域内,再回写该值(避免反射型漏洞) -
allowMethods必须显式包含"OPTIONS",否则预检失败 -
allowHeaders若含自定义头(如X-Auth-Token),也要列全
如何验证网关是否正确处理了 OPTIONS 预检
浏览器发预检时不会带 Cookie 或认证头,只看响应头和状态码。用 curl 模拟最可靠:
curl -X OPTIONS \ -H "Origin: http://localhost:3000" \ -H "Access-Control-Request-Method: POST" \ -H "Access-Control-Request-Headers: Content-Type,X-Auth-Token" \ -I http://your-gateway-host/api/v1/user
检查返回中是否有:
-
Access-Control-Allow-Origin: http://localhost:3000(不能是*) -
Access-Control-Allow-Credentials: true(如果需要) Access-Control-Allow-Methods: POST,OPTIONS-
Vary: Origin(Kratos 默认加,不用手动补;手写中间件漏掉会导致 CDN 缓存错误响应)
真正容易被忽略的是:网关配置生效后,前端仍可能因缓存旧的预检响应而持续失败——OPTIONS 响应会被浏览器或中间代理缓存,尤其当 Access-Control-Max-Age 设得过大时。调试阶段建议在 curl 命令里加 -H "Cache-Control: no-cache",或清空浏览器缓存重试。











