Go原生net/http中OPTIONS预检失败典型表现为404或500,根本原因是DefaultServeMux不处理OPTIONS方法,必须显式拦截并提前返回;同时Access-Control-Allow-Origin设为"*"与Credentials:true共存会遭浏览器静默丢弃。

Go原生net/http中OPTIONS预检失败的典型表现
浏览器发了OPTIONS请求,但返回404或500——不是CORS没配好,是压根没路由处理它。原生http.DefaultServeMux对OPTIONS方法完全无感知,也不会 fallback 到你的 handler。
必须显式拦截或由中间件提前响应,否则预检就断在第一步。
-
OPTIONS请求不能交给后续 handler 处理(比如数据库操作、日志写入),必须在中间件里直接w.WriteHeader(http.StatusOK)并返回 - 不要在 handler 里才判断
r.Method == "OPTIONS",得在中间件最开头做 - 若用自定义
http.ServeMux,需确保注册了OPTIONS路由,或统一用中间件兜底
Access-Control-Allow-Origin和Credentials冲突的硬性限制
Access-Control-Allow-Origin: "*"和Access-Control-Allow-Credentials: "true"不能共存——这不是 Go 的 bug,是浏览器强制规范。一旦同时出现,整个响应会被静默丢弃,Network 面板里连 status 都看不到。
要支持带 cookie 或 auth header 的请求,必须指定具体源,不能用通配符:
- ✅ 允许:
Access-Control-Allow-Origin: "https://myapp.com"+Access-Control-Allow-Credentials: "true" - ❌ 禁止:
Access-Control-Allow-Origin: "*"+Access-Control-Allow-Credentials: "true" - 动态白名单可用
handlers.AllowedOriginsFunc(gorilla/handlers)或AllowOriginFunc(gin-contrib/cors)
GIN框架里手写Header为什么总失效
在 GIN 的context里调用c.Header("Access-Control-Allow-Origin", "..."),看似写了,但常被后续中间件覆盖、或在预检阶段根本没执行到——因为 GIN 的c.Writer是封装过的,header 写入时机和顺序极敏感。
正确做法只有一条路:
- 必须用
gin-contrib/cors,通过router.Use(cors.New(...))注入,不要在 handler 里写c.Header() - 配置中启用
AllowCredentials: true时,AllowOrigins数组里不能含"*",否则初始化会 panic - 若需暴露自定义 header(如
X-Request-ID),必须显式加进ExposeHeaders字段
gorilla/handlers.CORS中间件的三个关键行为
它不是“多设几个 header”那么简单,而是完整接管预检生命周期:自动响应OPTIONS、校验 origin 合法性、控制 header 写入时机。安装后直接包一层 router 即可:
go get github.com/gorilla/handlers
常见误配点:
-
handlers.AllowedOrigins([]string{"*"})会自动禁用handlers.AllowCredentials(),这是对规范的主动防护,不是缺陷 - 要暴露自定义响应头(如
X-Total-Count),必须加handlers.ExposedHeaders([]string{"X-Total-Count"}) -
Access-Control-Allow-Headers必须包含前端实际发送的 header,比如用了X-Auth-Token却没声明,预检直接403
跨域通信规则本质是浏览器单方面执行的安全契约,Go 只负责按规范回应。最容易被忽略的点是:**预检请求的响应必须独立、完整、无副作用,且 header 设置必须在任何w.Write()或w.WriteHeader()之前完成**。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











