Go结构体存Redis的JSON序列化方法

本文深入讲解了在 Go 语言中如何将结构体安全、高效地存入 Redis 缓存——由于 Redis 仅支持字符串类型，必须借助标准库 `encoding/json` 进行序列化与反序列化，文章不仅提供了完整可运行的代码示例，还重点剖析了导出字段的必要性、struct tag 的灵活控制（如自定义键名、忽略空值）、接口级定制能力（Marshaler/Unmarshaler）以及动态结构的处理策略，帮助开发者避开常见陷阱，构建健壮、可维护的缓存交互逻辑。

Redis 仅支持字符串存储，Go 中需借助 encoding/json 将结构体安全序列化为 JSON 字符串，并可反序列化还原；关键要求是字段必须导出，且可通过 struct tag 精确控制字段名与行为。

Redis 仅支持字符串存储，Go 中需借助 `encoding/json` 将结构体安全序列化为 JSON 字符串，并可反序列化还原；关键要求是字段必须导出，且可通过 struct tag 精确控制字段名与行为。

在 Go 应用中与 Redis 交互时，常需将业务结构体（如用户、订单）持久化到缓存。由于 Redis 底层只接受 string 类型值，直接类型转换（如 string(myStruct)）会编译失败——Go 不允许对非字节切片/字符串类型做此类强制转换。正确做法是使用标准库 encoding/json 包进行序列化。

以下是一个典型工作流示例，展示如何将结构体存入 Redis 并安全读取：

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "github.com/go-redis/redis/v9"
)

type Person struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
    // 注意：字段首字母大写（导出），否则 json 包无法访问
}

func main() {
    // 示例：模拟 Redis 客户端（实际使用时替换为真实 rdb 实例）
    rdb := redis.NewClient(&redis.Options{Addr: "localhost:6379"})

    p := Person{Name: "Alice", Age: 30}

    // ✅ 步骤1：结构体 → JSON 字符串
    data, err := json.Marshal(p)
    if err != nil {
        log.Fatal("序列化失败:", err)
    }

    // ✅ 步骤2：存入 Redis（key: "user:1001"）
    err = rdb.Set(rdb.Context(), "user:1001", data, 0).Err()
    if err != nil {
        log.Fatal("写入 Redis 失败:", err)
    }
    fmt.Println("✅ 已存入 Redis:", string(data))

    // ✅ 步骤3：从 Redis 读取并反序列化
    val, err := rdb.Get(rdb.Context(), "user:1001").Bytes()
    if err != nil {
        log.Fatal("读取失败:", err)
    }

    var p2 Person
    err = json.Unmarshal(val, &p2)
    if err != nil {
        log.Fatal("反序列化失败:", err)
    }
    fmt.Printf("✅ 还原结构体: %+v\n", p2)
}

关键注意事项：

• ? 字段必须导出：所有需序列化的字段名必须以大写字母开头（如 Name, Age），否则 json 包通过反射无法读取，结果为空对象 {}；
• ?️ 灵活控制字段映射：使用 json:"field_name" tag 可自定义 JSON 键名（如 json:"email_addr"），支持忽略空值（json:",omitempty"）或指定时间格式；
• ⚙️ 高级定制：若需完全自定义序列化逻辑（如加密字段、兼容旧版协议），可实现 json.Marshaler 和 json.Unmarshaler 接口；
• ? 动态结构场景：对于运行时字段不确定的结构（如配置项、API 响应泛型），推荐使用 map[string]interface{} 或 json.RawMessage 延迟解析。

综上，json.Marshal() / json.Unmarshal() 是 Go 与 Redis 结构化数据交互的基石方案——简洁、标准、可靠。搭配合理的 struct tag 设计与错误处理，即可构建健壮的缓存层。

今天关于《Go结构体存Redis的JSON序列化方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！