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

阿萱同学_7747

阿萱同学_7747

2026-11-22

949人浏览

原创

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() 的封装,它不自动处理编码;你得自己包一层。

示例写法:

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()。漏掉任一环节都会导致解析失败或静默空值。

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

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

下载

常见错误现象: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(但需验证签名和过期)

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.07

2415

5

json是什么
json是什么

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

2023.08.23

4042

1

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

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

2023.10.13

1336

3

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

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

2025.09.10

4699

7

cookie
cookie

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

2023.06.30

13239

10

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

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

2023.11.23

1406

5

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

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

2024.02.23

904

5

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

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

2025.08.19

2046

14

热门下载

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

精品课程

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

共101课时 | 21.5万人学习

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

共39课时 | 5万人学习