使用Gin@v1.9.0获取JSON格式Cookie失败的问题求助

问题原因 #

Cookie值中的大括号、双引号属于HTTP Cookie规范中的特殊字符，若未进行URL编码，服务器端的标准库Cookie解析器会无法正确识别键值对结构，导致找不到指定的key。

解决方法 #

1. 客户端发送Cookie时编码特殊字符

发送前需对JSON格式的Cookie值做URL编码，以JavaScript为例：

const cookieValue = encodeURIComponent('{"ckey": "cvalue"}');
document.cookie = `key=${cookieValue}`;

2. 服务器端两种获取方式

• 使用Gin内置方法（推荐）
  Gin的c.Cookie()方法会自动处理URL解码，直接获取原始值：

  value, err := c.Cookie("key")
  if err != nil {
      // 错误处理逻辑
      return
  }
  // value即为解码后的JSON字符串：{"ckey": "cvalue"}
  

• 使用标准库方法手动解码
  若坚持使用c.Request.Cookie()，需手动对获取到的值解码：

  import "net/url"
  
  token, err := c.Request.Cookie("key")
  if err != nil {
      // 错误处理逻辑
      return
  }
  decodedValue, err := url.QueryUnescape(token.Value)
  if err != nil {
      // 解码错误处理
      return
  }
  // decodedValue为原始JSON字符串
  

为什么原始方式失败 #

c.Request.Cookie()调用的是Go标准库http.Request的Cookie解析逻辑，对未编码的特殊字符处理严格。当Cookie值包含未转义的双引号、大括号时，解析器会错误拆分Cookie字符串，导致无法匹配到目标key，从而返回http: named cookie not present错误。

内容的提问来源于stack exchange，提问作者Alan Millirud