不能仅用AllowOrigins: ["*"]和AllowCredentials: true,因浏览器禁止凭据模式下使用通配符*作为Access-Control-Allow-Origin值,否则预检失败、请求无法发出;必须白名单校验Origin并动态回写,同时前端设credentials: "include"、后端Cookie配SameSite=None且Secure=false(开发HTTP环境)。

不能只靠 AllowOrigins: []string{"*"} + AllowCredentials: true 就完事——浏览器会直接拒绝,请求根本发不出去。
为什么 Echo 默认 CORS 中间件不支持带 Cookie 的跨域
Echo 官方 middleware.CORS() 默认配置里 AllowOrigins 是 []string{"*"},而一旦你设了 AllowCredentials: true,浏览器就会强制要求 Access-Control-Allow-Origin 必须是具体域名(不能是 *),否则预检(OPTIONS)就失败,后续请求压根不会触发。
常见错误现象:
- 控制台报错 Failed to load http://api.example.com/login: The value of the 'Access-Control-Allow-Origin' header in the response must not be the wildcard '*' when the request's credentials mode is 'include'.
- 登录接口返回 200,但后续请求始终 401,Cookie 没进请求头
- 根本原因:Echo 原生中间件不支持动态读取
Origin并白名单校验,也没法在预检响应中安全地回写该 Origin - 你不能手动在 handler 里用
c.Response().Header().Set("Access-Control-Allow-Origin", c.Request().Header.Get("Origin"))—— 这样会引入反射 XSS 风险(恶意 Origin 可被原样回写) - 必须做 Origin 白名单校验,且只对合法来源才回写对应值
怎么改 Echo 的 CORS 中间件支持带 Cookie 跨域
核心是替换掉默认中间件,用自定义逻辑做 Origin 白名单 + 动态响应头。参考你知识库中那个 echo_cors 包的思路,关键点如下:
- 定义允许的 Origin 列表,比如
[]string{"https://app.example.com", "http://localhost:3000"},不要留空或用* - 在中间件中读取
c.Request().Header.Get("Origin"),逐个比对是否在白名单内;匹配则设Access-Control-Allow-Origin为该值,否则跳过(或返回 403) - 必须同时设置
Access-Control-Allow-Credentials: "true",且仅当 Origin 匹配成功时才设(避免对非法 Origin 也开凭据) - 确保
OPTIONS请求也被中间件捕获并正确响应——很多问题卡在这儿,因为预检失败后浏览器连主请求都不发
示例片段(非完整中间件,仅示意逻辑):
if origin := c.Request().Header.Get("Origin"); origin != "" {
for _, allowed := range config.AllowOrigins {
if origin == allowed {
c.Response().Header().Set("Access-Control-Allow-Origin", origin)
c.Response().Header().Set("Access-Control-Allow-Credentials", "true")
break
}
}
}后端 Cookie 设置本身也得合规
就算 CORS 头全对,浏览器仍可能丢弃 Set-Cookie 响应——尤其 Chrome 80+ 后,默认 SameSite=Lax,跨域请求下必须显式声明 SameSite=None 且 Secure=true(HTTPS 环境)。
- 开发时若用 HTTP(如
http://localhost:3000→http://localhost:1323),Secure=true会被浏览器拒绝,此时可临时设Secure=false,但必须配合SameSite=http.SameSiteNoneMode - Go 1.15+ 才支持
http.SameSiteNoneMode;旧版本需用整数0x03替代,否则编译报错 -
Domain字段别乱填:跨子域(如app.example.com→api.example.com)才设Domain: ".example.com";同域不同端口不用设 Domain
正确构造 Cookie 示例:
c := &http.Cookie{
Name: "session_id",
Value: "abc123",
Path: "/",
Domain: "", // 本地开发建议留空
MaxAge: 3600,
HttpOnly: true,
Secure: false, // 开发环境 HTTP 时设 false
SameSite: http.SameSiteNoneMode,
}
http.SetCookie(c.Response(), c)前端 fetch / axios 必须显式开启凭据
服务端全配对了,前端不主动要,Cookie 依然不会发。
- fetch:必须加
credentials: "include",不能省略或写成"same-origin" - axios:设
withCredentials: true,且确保没被全局拦截器覆盖 - 注意:如果前端用的是相对路径(如
/api/login),但实际部署在不同域名下,仍算跨域,一样要配凭据
漏掉这个,控制台看不到报错,但 Network 面板里 Request Headers 就是没 Cookie 字段——这是最常被忽略的一环。
真正卡住的点往往不在某一个配置,而在「CORS 响应头 + Cookie 属性 + 前端凭据开关」三者没对齐。尤其是本地开发时 HTTP + SameSite=None + Secure=false 的组合,稍一疏忽,Chrome 就静默丢 Cookie,连控制台都不提示。


















