在Gin框架中如何无需序列化将结构体从中间件传递到处理函数

1. 原生直接传递方案（无需序列化） #

首先明确：Gin的*gin.Context提供的Set方法支持存储任意interface{}类型的值，完全不需要提前对结构体做序列化操作，可以直接将自定义结构体实例存入上下文，后续处理函数取出后仅需做类型断言即可使用。

代码实现 #

中间件存储逻辑

func Middleware(ctx *gin.Context) {
  data := GetData()
  // 直接存入结构体实例，key可自定义，建议避免硬编码重复使用
  ctx.Set("user_data", data)
  // 执行后续处理链路
  ctx.Next()
}

后续Handler取值逻辑

func BusinessHandler(ctx *gin.Context) {
  // 取值同时做类型断言，ok判断用于处理值不存在/类型不匹配的异常场景
  data, ok := ctx.Get("user_data").(Data)
  if !ok {
    ctx.JSON(500, gin.H{"error": "上下文数据异常"})
    return
  }
  // 直接使用结构体实例即可
  ctx.JSON(200, gin.H{
    "key1": data.Key1,
    "key2": data.Key2,
  })
}

更安全的封装方案 #

为了避免硬编码Key导致的拼写错误、以及重复写类型断言的冗余代码，可以封装专属的存取工具函数：

// 自定义私有包级的key类型，避免不同包之间的key命名冲突
type ctxKey string
const userDataKey ctxKey = "user_data"

// 存数据工具函数
func SetUserData(ctx *gin.Context, data Data) {
  ctx.Set(string(userDataKey), data)
}

// 取数据工具函数
func GetUserData(ctx *gin.Context) (Data, bool) {
  val, exist := ctx.Get(string(userDataKey))
  if !exist {
    return Data{}, false
  }
  data, ok := val.(Data)
  return data, ok
}

封装后中间件调用SetUserData(ctx, data)存值，Handler调用data, ok := GetUserData(ctx)取值即可，安全性更高。

2. 序列化/反序列化方案（仅适用于跨进程/跨服务传递场景） #

如果你的场景确实需要序列化存储（比如需要将数据存入Redis、传递给其他异构服务），可以选择以下两种安全实现：

• Gob序列化：Go原生专属序列化方案，支持绝大多数Go原生类型、自定义结构体，不需要额外给结构体加标签，序列化效率高，但仅可在Go程序之间交互使用。
• JSON序列化：通用跨语言序列化方案，需要保证结构体字段是导出的（首字母大写），可按需添加json标签指定序列化后的字段名，适用范围广。

内容的提问来源于stack exchange，提问作者Lee Maan