本文详解如何使用 go 的 encoding/json 包将结构体（struct）高效、可靠地序列化为 json 字符串，以满足 redis 仅支持字符串存储的约束，并涵盖字段导出规则、结构体标签控制、接口自定义等关键实践。
本文详解如何使用 go 的 encoding/json 包将结构体（struct）高效、可靠地序列化为 json 字符串，以满足 redis 仅支持字符串存储的约束，并涵盖字段导出规则、结构体标签控制、接口自定义等关键实践。
Redis 作为内存键值数据库，其底层只接受字节数组（即字符串）作为值类型。因此，在 Go 中将结构体存入 Redis 前，必须先将其序列化为可存储的字符串格式。encoding/json 是标准库中最为常用且生产就绪的方案，它能将结构体双向转换为 JSON 字符串，天然适配 Redis 的存储模型。
以下是一个典型示例，展示如何将结构体序列化后写入 Redis（以 github.com/go-redis/redis/v9 客户端为例）：
package main
import (
"context"
"encoding/json"
"fmt"
"time"
"github.com/go-redis/redis/v9"
)
type Person struct {
Name string `json:"name"`
Age int `json:"age"`
// 注意：字段名首字母必须大写（导出），否则 json 包无法访问
}
func main() {
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379",
})
defer rdb.Close()
ctx := context.Background()
p := Person{Name: "Alice", Age: 30}
// ✅ 正确：使用 json.Marshal 将结构体转为 []byte
data, err := json.Marshal(p)
if err != nil {
panic(fmt.Sprintf("JSON marshal failed: %v", err))
}
// 存入 Redis，设置过期时间 1 小时
err = rdb.Set(ctx, "user:1001", data, 1*time.Hour).Err()
if err != nil {
panic(fmt.Sprintf("Redis set failed: %v", err))
}
fmt.Println("Struct stored successfully as JSON string")
// 读取并反序列化
val, err := rdb.Get(ctx, "user:1001").Bytes()
if err != nil {
panic(fmt.Sprintf("Redis get failed: %v", err))
}
var p2 Person
if err := json.Unmarshal(val, &p2); err != nil {
panic(fmt.Sprintf("JSON unmarshal failed: %v", err))
}
fmt.Printf("Retrieved: %+v\n", p2) // 输出：{Name:Alice Age:30}
}⚠️ 关键注意事项：
- 字段必须导出：Go 中只有首字母大写的字段（如 Name, Age）才能被 json 包通过反射访问；小写字段（如 name, age）会被忽略，导致序列化结果为空或缺失。
- 结构体标签（struct tags）增强控制：通过 `json:"field_name"` 可自定义 JSON 键名；使用 `json:"-"` 可忽略该字段；`json:"field_name,omitempty"` 可在值为零值时省略该字段。
- 避免类型断言错误：string(the_struct) 是非法操作——Go 不允许直接将结构体强制转为字符串，编译器会报错 cannot convert the_struct (type Person) to type string。务必使用 json.Marshal() 或其他序列化方法。
- 性能与替代方案：对高频、低延迟场景，可考虑更紧凑的二进制格式（如 encoding/gob 或 Protocol Buffers），但需确保客户端兼容性；JSON 因其可读性、跨语言通用性及 Redis 原生友好性，仍是绝大多数场景的首选。
- 错误处理不可省略：json.Marshal 和 json.Unmarshal 均返回 error，尤其在字段类型不匹配、嵌套结构非法或 JSON 格式损坏时可能失败，生产代码中必须显式检查。
此外，若结构体模式动态不确定（如配置项、用户自定义字段），可改用 map[string]interface{} 进行灵活序列化；对于极致定制需求，还可实现 json.Marshaler 和 json.Unmarshaler 接口，完全接管序列化逻辑。
综上，json.Marshal + json.Unmarshal 是 Go 与 Redis 协同工作的标准范式——简洁、健壮、易维护。只要遵循导出规则、善用标签、严谨处理错误，即可安全、高效地实现结构化数据在 Redis 中的持久化与检索。
