讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

Echo框架Context怎么设置和读取Cookie

星杰酱_1472

星杰酱_1472

发布时间:2026-11-17 06:36:55

|

672人浏览过

|

来源于php中文网

原创

Echo中设置Cookie必须用c.SetCookie()传入*http.Cookie实例,禁用手动http.SetCookie;读取用c.Cookie()并检查http.ErrNoCookie错误,MaxAge优先于Expires,Secure和HttpOnly生产环境必须设为true。

echo框架context怎么设置和读取cookie

echo.Context 设置 Cookie 的正确方式

SetCookie 是 echo.Context 提供的原生方法,但它的参数顺序和底层 http.SetCookie 不同,容易传错。它接受 6 个参数:c(上下文)、name、value、maxAge(秒)、path、domain、secure、httpOnly、samesite —— 注意:不是所有版本都支持最后 4 个布尔参数,v4.10+ 才完整支持命名参数形式(实际是通过结构体传参)。

更稳妥、兼容性更好的写法是手动构造 http.Cookie 并用 c.SetCookie() 注入:

cookie := &http.Cookie{
    Name:     "theme",
    Value:    "dark",
    MaxAge:   3600,
    Path:     "/",
    Domain:   "example.com",
    Secure:   true,
    HttpOnly: true,
    SameSite: http.SameSiteLaxMode,
}
c.SetCookie(cookie)

常见错误:直接调用 c.SetCookie("name", "val", 3600) 会 panic,因为旧版签名只接受 4 个参数且无 Secure/HttpOnly 控制;v4.10+ 虽支持变参,但漏掉 path 或 domain 可能导致 Cookie 不被浏览器发送回来。

echo.Context 读取 Cookie 的注意事项

c.Cookie() 用于按名读取单个 Cookie,返回 *http.Cookie 和 error。它不会自动解码 URL 编码值(如空格变 +、特殊字符变 %xx),但 Go 的 http.Request 底层已自动处理,你拿到的 cookie.Value 已是解码后的原始字符串。

关键点:

  • 如果 Cookie 不存在,c.Cookie("token") 返回 nil, http.ErrNoCookie,不是 nil, nil
  • 不要用 c.Request().Cookie("name"),它绕过 Echo 的中间件逻辑(比如压缩、日志),且在某些中间件后可能读不到最新值
  • 多个同名 Cookie(极少见)时,c.Cookie() 只返回第一个,浏览器本就不该发多个同名 Cookie

示例判断逻辑:

Cookiecutter Template Generator
Cookiecutter Template Generator

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

下载
cookie, err := c.Cookie("session_id")
if errors.Is(err, http.ErrNoCookie) {
    // 未设置,走登录流程
    return c.JSON(http.StatusUnauthorized, map[string]string{"error": "no session"})
}
if err != nil {
    return c.JSON(http.StatusInternalServerError, map[string]string{"error": "read cookie failed"})
}
// 此时 cookie.Value 是可用字符串
fmt.Println(cookie.Value)

Secure 和 HttpOnly 在生产环境必须显式设为 true

开发时本地 HTTP 站点常忽略 Secure: true,但一旦部署到 HTTPS 域名下,不设 Secure 会导致浏览器拒绝发送该 Cookie(即使域名匹配)。而 HttpOnly: true 能防止 XSS 直接读取敏感 Cookie(如 auth_token)。

容易踩的坑:

  • 使用 echo.New() 默认不开启 HTTPS 检测,c.IsTLS() 在反向代理后可能始终返回 false,别依赖它动态开关 Secure
  • 正确做法是通过环境变量或配置项硬编码:比如 env == "prod" 时强制 Secure: true、HttpOnly: true
  • SameSite 建议设为 http.SameSiteLaxMode(防 CSRF 且兼容大部分跳转),除非业务明确需要 Strict 或允许 None(后者必须配 Secure: true)

Cookie 过期时间用 MaxAge 而非 Expires

MaxAge 是秒数(如 3600),Expires 是绝对时间(time.Time)。Echo 内部优先使用 MaxAge,若为 0 则忽略 Expires;若 MaxAge ,则设为会话 Cookie(浏览器关闭即失效)。

为什么推荐 MaxAge:

  • 客户端时钟可能不准,Expires 依赖客户端时间,容易提前失效
  • MaxAge 是相对时间,服务端控制更可靠
  • 大部分现代浏览器对 MaxAge 支持完善,无需降级

注意:不要同时设置 MaxAge 和 Expires,Echo 会以 MaxAge 为准,Expires 被忽略。

Cookie 的生命周期、作用域和安全标记一旦设错,前端就收不到、发不回、或被 JS 窃取——这些细节没有报错提示,只能靠抓包或浏览器开发者工具里的 Application → Cookies 面板逐项核对。

热门AI工具

更多
小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

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

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

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

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

WorkBuddy

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

DeepSeek

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

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
cookie
cookie

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

13039

2023.06.30

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

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

1366

2023.11.23

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

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

904

2024.02.23

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

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

2006

2025.08.19

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

100

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

60

2026.11.12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

160

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

140

2026.11.06

热门下载

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

精品课程

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