讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

Echo框架中Cookie路径与作用域的设置技巧

云敏大大_4915

云敏大大_4915

发布时间:2026-11-20 09:05:17

|

775人浏览过

|

来源于php中文网

原创

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

echo框架中cookie路径与作用域的设置技巧

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 都无效。

Cookiecutter Template Generator
Cookiecutter Template Generator

使用 Cookiecutter CLI 和 Jinja2 模板生成项目脚手架。支持自定义模板注册表、通过 Python 脚本的生成后钩子,以及与 GitHub 模板仓库 API 的集成。

下载
  • 本地开发常用 localhost:但浏览器禁止对 localhost 设置 Domain,此时只能靠 Path 控制范围
  • 生产环境务必用带点的泛域名,如 .myapp.com
  • Domain 和 Path 是协同生效的:先按 Domain 匹配域名,再按 Path 匹配路径

Secure 和 HttpOnly 不是“加了更安全”,而是上线前必须核对的硬性开关

这两个布尔字段一旦设错,轻则 Cookie 不发送,重则被 XSS 直接窃取。

  • 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 能按预期工作;任意一项配置错误,都可能导致前端收不到、发不出、或被拦截。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

13159

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1406

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

904

2024.02.23

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

2026

2025.08.19

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

60

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

60

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

20

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

60

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Revel 官方 app.conf 文档
Revel 官方 app.conf 文档

共0课时 | 0人学习

php注册登录系统开发实战
php注册登录系统开发实战

共10课时 | 13.8万人学习

PHP基于Cookie的购物车模块设计
PHP基于Cookie的购物车模块设计

共10课时 | 11.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn