Echo框架本身不自动设置Cookie安全属性,必须显式配置HttpOnly、Secure和SameSite;漏配任一属性将导致Cookie裸奔,XSS与CSRF风险极高。

直接说结论:Echo 框架本身不自动设置任何 Cookie 安全属性,Set-Cookie 响应头完全由你手动控制;不加 HttpOnly、Secure、SameSite,Cookie 就是裸奔状态,XSS 一打一个准,CSRF 也基本防不住。
Set-Cookie 三个关键属性必须显式配置
Go 的 http.SetCookie 或 Echo 的 c.SetCookie() 不会默认启用任何安全限制。哪怕你用 echo-jwt 中间件签发 token,它也不会自动加 HttpOnly——这是常见翻车点。
-
HttpOnly:阻止 JavaScript 读取,防 XSS 窃取会话 ID。漏配时document.cookie能直接拿到值 -
Secure:强制仅 HTTPS 传输。开发环境常关掉,但上线前必须开,否则明文走 HTTP -
SameSite:推荐设为Lax(防 CSRF 同时兼容大部分跳转)或Strict(更严,但可能影响 OAuth 流程)。设成None必须同时配Secure,否则浏览器拒绝
echo-jwt v4 怎么配 HttpOnly + Secure
echo-jwt v4 默认只做签名验证,不操作 Cookie 属性。你要自己在签发 token 时手动调用 c.SetCookie(),不能依赖中间件自动塞。
使用 Cookiecutter CLI 和 Jinja2 模板生成项目脚手架。支持自定义模板注册表、通过 Python 脚本的生成后钩子,以及与 GitHub 模板仓库 API 的集成。
- 不要用
c.Cookie()读取,它不校验签名;要用c.Get("user")(来自 JWT 中间件注入) - 写入时必须传完整选项:
c.SetCookie("jwt", token, 3600, "/", "yourdomain.com", true, true)—— 最后两个布尔值分别对应Secure和HttpOnly -
SameSite需要额外设置:Go 标准库 1.19+ 支持http.SameSiteLaxMode,传给http.Cookie{SameSite: http.SameSiteLaxMode};旧版本得拼字符串"SameSite=Lax"到Header().Set()
SameSite=Lax 在 Echo 中的兼容性坑
Chrome 80+ 强制升级 SameSite 默认行为,但 Echo 自身不干预响应头。如果你没显式设 SameSite,浏览器会按新规则当成 Lax 处理,但部分老客户端(比如某些 Android WebView)可能直接拒收。
- 测试时用 Chrome DevTools → Application → Cookies,看实际响应头里有没有
SameSite=Lax - 若用反向代理(如 Nginx),确保它没覆盖或删掉
Set-Cookie头;有些配置会 strip 掉带SameSite=None的头 - 登录页重定向到第三方 OAuth 提供商时,
SameSite=Strict会导致 Cookie 不随跳转发送,必须降级为Lax
真正容易被忽略的不是“怎么配”,而是“谁在写 Cookie”。业务 handler、JWT 中间件、自定义登录逻辑……多个地方都可能调用 SetCookie,只要有一处漏了 HttpOnly 或 Secure,整条链就破防。上线前务必用 curl -I 或浏览器开发者工具逐个接口验证响应头。

















