讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

SoundView
SoundView

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

AniShort
AniShort

AI短剧协同制作平台

Echo框架Cookie怎么设置?常用属性配置指南

冬静同学_5849

冬静同学_5849

发布时间:2026-11-22 06:49:30

|

958人浏览过

|

来源于php中文网

原创

必须用c.SetCookie()设置Cookie,它是Echo框架唯一安全入口;手动调用http.SetCookie或Header().Set("Set-Cookie",...)会导致冲突、忽略或空Cookie,且c.Cookie()可能读不到。

echo框架cookie怎么设置?常用属性配置指南

Cookie 设置必须用 c.SetCookie(),不能手动调用 http.SetCookie

直接操作 http.ResponseWriter.Header().Set("Set-Cookie", ...) 或 http.SetCookie() 会导致 Header 冲突、重复写入被忽略,甚至返回空 Cookie。Echo 封装了所有 Cookie 操作入口,c.SetCookie() 是唯一安全写法。

常见错误是先 new 一个 http.Cookie,再传给 http.SetCookie() —— 这绕过了 Echo 的上下文管理,后续 c.Cookie("name") 可能读不到,或中间件(如 CORS、Logger)无法正确处理。

  • c.SetCookie() 接收的是 *http.Cookie 实例,不是键值对字符串
  • 必须显式初始化 Name 和 Value,否则会 panic
  • Path 建议设为 "/"(全站可用),否则子路径下读不到
  • 若不设 Domain,浏览器默认只在当前主机名下生效(localhost ≠ 127.0.0.1)

http.Cookie.MaxAge 和 Expires 别同时设

两者语义重叠,浏览器可能忽略其中一个,甚至拒收整个 Cookie。优先用 MaxAge(整数秒),它更明确、兼容性更好;Expires 是绝对时间,容易因服务器/客户端时钟偏差出错。

Cookiecutter Template Generator
Cookiecutter Template Generator

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

下载
  • MaxAge = 0:按会话 Cookie 处理(关闭浏览器即失效)
  • MaxAge (如 <code>-1):等效于删除,浏览器立即丢弃
  • MaxAge > 0:从响应发出时刻起计时,不受客户端时间影响
  • 如果非要设 Expires,请用 time.Now().Add(...).UTC(),避免本地时区问题

跨域请求带 Cookie 必须配 AllowCredentials: true

前端 fetch 或 axios 设了 credentials: "include",但后端没开凭据支持,浏览器会静默丢弃 Cookie —— 看似请求成功,c.Cookies() 却为空。

  • 启用 middleware.CORS() 时,AllowCredentials 必须为 true
  • AllowOrigins 不能为 "*",必须指定具体域名(如 ["https://example.com"]),否则浏览器拒绝发送 Cookie
  • Secure: true 的 Cookie 在 HTTP 环境下不会发送,开发时若用 http://localhost,需设 Secure: false
  • HttpOnly: true 防 XSS,但 JS 就读不到该 Cookie(适合存 token);SameSite: "Lax" 或 "Strict" 防 CSRF,现代浏览器默认行为趋严

读取和删除 Cookie 的易错点

c.Cookie("name") 返回 *http.Cookie 和 error,错误类型固定为 http.ErrNoCookie。别用 if err != nil 泛判,否则网络错误、解析失败等也会进同一分支。

  • 读取前建议先检查是否存在:if cookie, err := c.Cookie("token"); err == nil { ... }
  • 删除本质是覆盖写入一个已过期的 Cookie:cookie.MaxAge = -1,再调 c.SetCookie(cookie)
  • 不要依赖 c.Cookies() 遍历删全部 —— 它只返回本次请求携带的 Cookie,不包含刚 set 但未下发的
  • Domain 和 Path 必须与设置时完全一致,否则删除无效(例如设置时 Domain="example.com",删除时漏写就删不掉)
实际项目里最容易被忽略的是 Domain 和 Path 的一致性,以及跨域场景下 AllowCredentials 与 AllowOrigins 的联动约束 —— 这两个点一旦配错,现象都是“Cookie 看不见”,但原因完全不同。

热门AI工具

更多
SoundView
SoundView Hot

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

豆包大模型

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

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

DeepSeek

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
cookie
cookie

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

13239

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的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

2046

2025.08.19

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

0

2026.11.20

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

0

2026.11.20

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

0

2026.11.20

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

0

2026.11.20

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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