Redis 仅支持字符串存储，Go 中需借助 encoding/json 将结构体安全序列化为 JSON 字符串，并可反序列化还原；关键要求是字段必须导出，且可通过 struct tag 精确控制字段名与行为。
redis 仅支持字符串存储，go 中需借助 `encoding/json` 将结构体安全序列化为 json 字符串，并可反序列化还原；关键要求是字段必须导出，且可通过 struct tag 精确控制字段名与行为。
在 Go 应用中与 Redis 交互时，常需将业务结构体（如用户、订单）持久化到缓存。由于 Redis 底层只接受 string 类型值，直接类型转换（如 string(myStruct)）会编译失败——Go 不允许对非字节切片/字符串类型做此类强制转换。正确做法是使用标准库 encoding/json 包进行序列化。
以下是一个典型工作流示例，展示如何将结构体存入 Redis 并安全读取：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
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 设计与错误处理，即可构建健壮的缓存层。
