Cookie需显式设Path="/"才能全站生效,Domain必须为".example.com"实现子域共享,Secure和HttpOnly上线前必核对,MaxAge=-1是标准删除方式。

Cookie.Path 必须显式设为 "/" 才能跨路径生效
浏览器默认把 Set-Cookie 的 Path 设为当前请求完整路径(比如 /admin/login),导致该 Cookie 只在精确匹配该路径时才随请求发送。绝大多数场景下这毫无用处——登录后跳转到 /dashboard 就拿不到 Cookie 了。
正确做法是始终显式设置 cookie.Path = "/",让 Cookie 在整个域名下所有路径都可用。不写这行,c.SetCookie() 看似成功,实际前端几乎无法复用。
-
Path = "/":根路径,全站有效 -
Path = "/api":仅/api/xxx及其子路径有效 -
Path = "/admin":不匹配/admin后无斜杠的请求(如/admin?tab=1) - 路径比较大小写敏感,
/Admin和/admin是两个不同作用域
Domain 属性不是可选的“锦上添花”,而是跨子域共享的前提
如果你的前端部署在 app.example.com,后端 API 在 api.example.com,不设 Domain 就永远无法共享 Cookie。浏览器默认只把 Cookie 绑定到发起请求的**完整主机名**,app.example.com 写的 Cookie 不会自动发给 api.example.com。
要实现子域共享,必须设 cookie.Domain = ".example.com"(注意开头的点)。这个点表示“及其所有子域”。漏掉点、写成 example.com 或 www.example.com 都无效。
- 本地开发常用
localhost:但浏览器禁止对localhost设置Domain,此时只能靠Path控制范围 - 生产环境务必用带点的泛域名,如
.myapp.com -
Domain和Path是协同生效的:先按 Domain 匹配域名,再按 Path 匹配路径
Secure 和 HttpOnly 不是“加了更安全”,而是上线前必须核对的硬性开关
这两个布尔字段一旦设错,轻则 Cookie 不发送,重则被 XSS 直接窃取。
使用 Cookiecutter CLI 和 Jinja2 模板生成项目脚手架。支持自定义模板注册表、通过 Python 脚本的生成后钩子,以及与 GitHub 模板仓库 API 的集成。
-
Secure = true:强制 Cookie 只通过 HTTPS 传输。HTTP 站点设了它,浏览器直接丢弃该 Cookie -
HttpOnly = true:禁止 JavaScript 访问(document.cookie读不到)。登录态、Session ID 类 Cookie 必须开,否则 XSS 攻击可直接盗 token - 开发环境用 HTTP 时,
Secure必须为false;切勿用环境变量动态控制——容易漏配或误配 - Chrome DevTools → Application → Cookies 里能看到每个字段是否生效,建议每次改完立刻验证
MaxAge 和 Expires 别同时设,且 MaxAge = -1 才是标准删 Cookie 方式
http.Cookie 中 Expires 和 MaxAge 是互斥的。浏览器看到两者都存在时,可能忽略其中一个,行为不一致。
推荐统一用 MaxAge:
-
MaxAge = 0:不设过期时间,浏览器关掉就失效(session cookie) -
MaxAge = 3600:1 小时后自动过期 -
MaxAge = -1:立即删除(等价于把过期时间设为过去,但更明确、更可靠) - 别用
Expires = time.Now().Add(-1 * time.Hour)模拟删除——时区、客户端时间偏差都会导致失败
路径、域名、安全属性、过期策略这四者必须一起考虑。单独调对一个字段,不代表 Cookie 能按预期工作;任意一项配置错误,都可能导致前端收不到、发不出、或被拦截。










