讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

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

Echo框架怎么将JSON对象安全存入Cookie

阿萱同学_7747

阿萱同学_7747

发布时间:2026-11-22 07:00:29

|

949人浏览过

|

来源于php中文网

原创

Cookie只能存字符串,JSON对象必须先序列化:Echo中需用json.Marshal()转字符串,再url.QueryEscape()编码后通过c.SetCookie()写入;读取时先url.QueryUnescape()再json.Unmarshal(),且单个Cookie不宜超过4KB。

echo框架怎么将json对象安全存入cookie

Cookie只能存字符串,JSON对象必须先序列化

Echo 框架本身不提供直接存结构体到 Cookie 的能力,c.SetCookie() 只接受 *http.Cookie,而它的 Value 字段是 string 类型。所以你不能把 map[string]interface{} 或自定义 struct 直接塞进去——会 panic 或静默截断。

正确路径是:先用 json.Marshal() 转成 JSON 字符串,再 URL 编码(防止特殊字符破坏 Cookie 格式),最后设值。反向读取时,要先解码再 json.Unmarshal()。

  • 不编码直接存 JSON 字符串,遇到 { "name": "张三", "role": "admin" } 里的空格、中文、引号会触发 http.SetCookie 内部解析失败,浏览器可能丢弃整个 Cookie
  • 别用 base64.StdEncoding.EncodeToString() 替代 URL 编码——它生成的 + 和 / 在 Cookie 中会被误解析为空格或路径分隔符
  • 推荐用 url.QueryEscape() 编码,它专为 HTTP 上下文设计,兼容性最稳

怎么用 echo.Context 安全写入带 JSON 内容的 Cookie

注意:Echo 的 c.SetCookie() 是对 http.SetCookie() 的封装,它不自动处理编码;你得自己包一层。

示例写法:

Exa JS Web Search SDK 用于 AI 应用程序
Exa JS Web Search SDK 用于 AI 应用程序

exa-js 是 Exa 官方 JavaScript 软件开发工具包,Exa 是一个为 AI 工作流构建的网络搜索 API。它为代理提供了一种具体的方式来搜索网络、检索页面内容,并从代码中生成有来源的答案,而不是手动拼接原始 HTTP 调用。

下载
import (
    "encoding/json"
    "net/url"
    "net/http"
)

type UserInfo struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Role  string `json:"role"`
}

func setJSONCookie(c echo.Context, name string, value interface{}) error {
    b, err := json.Marshal(value)
    if err != nil {
        return err
    }
    encoded := url.QueryEscape(string(b))
    
    cookie := &http.Cookie{
        Name:     name,
        Value:    encoded,
        Path:     "/",
        MaxAge:   3600,
        HttpOnly: true,
        Secure:   c.Request().TLS != nil, // 生产环境应强制 true
        SameSite: http.SameSiteLaxMode,
    }
    c.SetCookie(cookie)
    return nil
}

// 使用
err := setJSONCookie(c, "user", UserInfo{ID: 123, Name: "Alice", Role: "user"})
if err != nil {
    return err
}
  • MaxAge 建议显式设置,不依赖 Expires(部分旧客户端对 RFC 时间格式支持差)
  • HttpOnly: true 必须开启,否则前端 JS 可读取并泄露敏感字段
  • Secure 判断不能只看域名,要检查 c.Request().TLS != nil,避免本地开发时硬编码出错

读取时如何避免 json.Unmarshal 失败或 panic

从 c.Cookie("user") 拿到的是 *http.Cookie,它的 Value 是原始字符串,必须先 url.QueryUnescape(),再 json.Unmarshal()。漏掉任一环节都会导致解析失败或静默空值。

常见错误现象:json: cannot unmarshal string into Go value of type main.UserInfo,本质是 Value 还带着 %7B%22id%22%3A123%7D 这种编码没解。

  • 始终检查 c.Cookie(name) 返回是否为 nil,空 Cookie 不该继续解析
  • 用 json.Unmarshal([]byte(raw), &target),不要传 raw 字符串本身(类型不匹配)
  • 建议封装读取函数,统一处理 decode + unmarshal 错误,并返回明确的 error 类型(比如 ErrCookieInvalid),方便上层判断是否需重定向登录

为什么不能把大 JSON 对象往 Cookie 里塞

Cookie 单个值上限约 4KB,但实际安全阈值更低——HTTP 头总大小通常被服务器限制在 8–16KB,多个 Cookie 累加很容易超限。Nginx 默认 large_client_header_buffers 是 8KB,Apache 也有类似限制。

更关键的是:每次请求,浏览器都会把所有同域 Cookie 自动附在 Cookie: 请求头里。一个 3KB 的用户信息 Cookie,意味着每秒 1000 QPS 就多发 3MB 带宽,且无法压缩。

  • 只存必要字段:比如 { "id": 123, "role": "admin" },别塞完整用户表记录或 token 原文
  • 敏感字段如 password、token 绝对禁止明文存 Cookie;应使用短期有效的加密 session ID 配合后端查库
  • 如果真需要存较多结构化数据,改用 localStorage + 后端接口校验,或用 short-lived JWT 存进 HttpOnly Cookie(但需验证签名和过期)

热门AI工具

更多
讯飞智文

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

WorkBuddy

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

豆包大模型

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

Loomy
Loomy Hot

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

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

DeepSeek

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

SoundView
SoundView Hot

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

PixPix
PixPix Hot

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2415

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

4042

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1336

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4699

2025.09.10

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

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.5万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 5万人学习

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

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