生产环境禁用 cors.New() 默认配置,因其 AllowOrigins: "*" 与 AllowCredentials: true 冲突会导致浏览器静默拦截请求;必须显式指定协议、端口、路径均匹配的白名单域名。

CORS 中间件必须显式配置白名单,AllowOrigins: ["*"] 在携带凭据时会被浏览器直接拒绝,不是“能用”,而是“根本不会发请求”。
为什么 cors.New() 默认配置不能直接上生产
Fiber 的 cors.New() 默认允许所有源(AllowOrigins: "*"),但这个配置在前端带 credentials: true(比如 Cookie、Authorization 头)时,浏览器会直接拦截请求,连 OPTIONS 预检都不会发——这不是后端没响应,是浏览器从源头就拦了。
- 必须把
AllowCredentials: true和AllowOrigins显式写成具体域名列表,例如[]string{"https://a.com", "https://b.com:8080"} - 协议、端口、尾部斜杠都算不同 origin:前端发的是
https://a.com/,白名单写https://a.com→ 拒绝;前端是http://localhost:3000,白名单漏了http://→ 拒绝 - 开发环境可临时用
AllowOriginsFunc做宽松匹配,但上线前必须切回静态白名单或带校验的动态逻辑(比如解析Host后比对子域名)
cors.New() 常见参数组合与陷阱
关键参数不是孤立的,它们之间有强约束关系:
-
AllowCredentials: true时,AllowOrigins不能含"*",否则中间件启动会 panic(Fiber v2.50+ 版本已加校验) -
ExposedHeaders要写全前端 JS 需要读取的响应头,比如["X-Request-ID", "Content-Disposition"];漏写会导致 JS 拿不到值 -
MaxAge控制预检缓存时间(单位秒),设太小(如 60)会让频繁请求反复触发 OPTIONS;设太大(如 86400)可能让变更后的 CORS 策略延迟生效 - 如果用了
AllowOriginsFunc,别直接return true,应做 host 解析和白名单比对,否则正则绕过风险高(比如.*\.trusted.com可被evil.trusted.com.attacker.com利用)
静态资源路由与 CORS 的顺序问题
Fiber 中 app.Static() 是独立路由处理器,它不经过中间件链——也就是说,如果你只在全局注册了 cors.New(),但没把它插在 Static 前面,那么所有静态文件(如 /assets/logo.png)响应将不含 CORS 头。
- 正确做法:把
cors.New()放在app.Static()之前,且确保它作用于整个应用(即调用app.Use(cors.New(...))) - 若只想给 API 路由开 CORS,而静态资源走 CDN 或 Nginx,则应把
cors.New()放到具体分组下,比如api := app.Group("/api"); api.Use(cors.New(...)) - SPA 场景下,
app.Static("/", "./public", fiber.Static{Index: "index.html"})必须配合 CORS 中间件,否则前端路由刷新后加载的 JS/CSS 也会被跨域拦截
多实例部署时的 CORS 限流兼容性
CORS 本身不涉及状态,但如果你在中间件里混入了限流(比如 limiter.New()),要注意:Fiber 的内存限流器只在单进程内有效。K8s 多副本场景下,limiter 会失效,但 cors 不受影响——这点常被误认为“CORS 配置没生效”,其实是限流逻辑干扰了判断。
- 验证 CORS 是否真正生效,看浏览器 Network 面板里响应头是否有
Access-Control-Allow-Origin,而不是看接口是否返回 429 - 若需统一限流策略,必须对接 Redis,且
limiter和cors应作为两个独立中间件注册,顺序无关(CORS 不依赖限流) - 调试时建议先禁用限流,确认 CORS 行为符合预期后再叠加其他中间件
最易被忽略的一点:前端 fetch 的 mode: "cors" 是默认行为,但一旦你手动加了 credentials: "include",后端就必须严格匹配 origin 白名单——这时候看日志没用,得打开浏览器 DevTools 的 Network 标签页,点开请求看“Response Headers”里有没有对应字段,没有就说明中间件根本没跑进去,大概率是注册顺序或路由匹配问题。











