必须将Domain属性设为以点开头的父域(如.example.com),才能实现主域名与所有子域名间Cookie共享;漏掉前导点号(如example.com)则仅主域名有效。

setcookie domain参数必须带前导点号
直接写 "example.com" 只能让主域名和同级路径读取,二级域名如 api.example.com 或 admin.example.com 无法访问。正确做法是显式指定 ".example.com"(注意开头的点),浏览器才会把 Cookie 发送给所有匹配的子域名。
常见错误包括:
- 漏掉点号,写成
"example.com"→ 仅example.com本身有效 - 多写点号,如
"..example.com"→ 浏览器拒绝存储 - 混用协议或端口差异:HTTP 和 HTTPS 下的 Cookie 默认不共享,
secure属性必须一致
Session中间件的Store必须支持跨域写入
Echo 自身不带 Session,靠 echo-contrib/session 提供能力。如果用了 sessions.NewCookieStore(),那 Cookie 本身就得满足跨二级域名条件——也就是上面说的 domain 参数;如果用了 sessions.NewRedisStore(),后端没问题,但前端仍需确保每次请求都携带合法的、domain 设置正确的 session ID Cookie。
关键点:
-
session.Middleware()的Options.Domain必须设为".example.com",否则中间件生成的 session Cookie 不会下发到子域名 - 没设
Options.Path时默认为"/",一般不用动;但若路由限定在/api下,又希望登录态全站生效,就得显式设Path: "/" - 使用
sessions.NewFilesystemStore()时,单机部署可行,但多实例下必须换 Redis,否则子域名请求可能落到不同机器,读不到 session
SameSite属性要设为 Lax 或 None(配合 Secure)
现代浏览器默认对跨二级域名的 Cookie 启用 SameSite=Lax 限制,这意味着从 admin.example.com 发起的 GET 请求可以带 Cookie,但 POST 表单提交或 iframe 加载时会被拦截。
使用 Cookiecutter CLI 和 Jinja2 模板生成项目脚手架。支持自定义模板注册表、通过 Python 脚本的生成后钩子,以及与 GitHub 模板仓库 API 的集成。
如果你的登录跳转或 API 调用涉及跨子域名提交(比如从 login.example.com 提交表单到 api.example.com),就必须设 SameSite=None,且强制开启 Secure:
-
SameSite=None单独使用会失败,浏览器要求必须同时设Secure: true - 开发环境用 HTTP 时,
Secure无法启用,可临时设SameSite=Lax并避免跨域 POST - Chrome 和 Edge 在 2025 年已默认将未声明 SameSite 的 Cookie 视为
Lax,不显式设置等于主动限流
测试时容易忽略的浏览器缓存与 Cookie 冲突
改完 domain 或 SameSite 后,浏览器不会自动清除旧 Cookie,导致新旧规则并存、行为混乱。最稳妥的验证方式是:
- 用隐身窗口重试,排除已有 Cookie 干扰
- 在 DevTools → Application → Cookies 中手动删掉所有
example.com下的条目再刷新 - 检查响应头中的
Set-Cookie字段是否含Domain=.example.com; Path=/; SameSite=Lax; Secure等完整属性 - 不要只看
document.cookie—— 它不显示HttpOnlyCookie,而 session ID 通常就是 HttpOnly 的
跨二级域名共享 Cookie 看似只改一个参数,实际是 domain、SameSite、Secure、Store 配置四者联动的结果。少设一项,就可能在某个浏览器或某种请求方式下静默失效。










