Redis/Rueidis 项目中的 JSON 切片解码优化

在 Redis/Rueidis 项目中，开发者们最近讨论了一个关于 JSON 数据解码的优化方案。这个方案主要解决了在处理 Redis 返回的多个 JSON 数据时，如何高效地将它们解码为 Go 语言中的结构体切片的问题。

背景与问题

在使用 Redis 的 MGET 命令获取多个键的值时，如果这些值都是 JSON 格式的结构体实例，开发者希望能够直接将结果解码到一个结构体切片中。然而，现有的 DecodeJSON 方法只能处理单个 JSON 字符串，无法直接处理包含多个 JSON 字符串的数组结果。

例如，当 key1 和 key2 的值都是 X 结构体的实例时：

type X struct {
    Name string
}

开发者希望这样使用：

xs := make([]*X, 0)
if err := redisClient.Do(ctx, s.redisClient.B().Mget().Key("key1", "key2").Build()).DecodeJSON(xs); err != nil {
    return err
}

但这种方法会失败，因为 DecodeJSON 无法直接处理切片。

解决方案

项目维护者提出了一个清晰且类型安全的解决方案：创建一个名为 DecodeSliceOfJSON 的辅助函数。这个函数专门用于处理 Redis 返回的数组结果，并将每个元素解码为指定的结构体类型。

func DecodeSliceOfJSON[T any](resp rueidis.RedisResult, target *[]*T) error {
    arr, err := resp.ToArray()
    if err != nil {
        return err
    }
    xs := make([]*T, len(arr))
    for i, a := range arr {
        if err = a.DecodeJSON(xs[i]); err != nil && !rueidis.IsRedisNil(err) {
            return err
        }
    }
    *target = xs
    return nil
}

使用方式如下：

var xs []*X
err := DecodeSliceOfJSON(client.Do(context.Background(), client.B().Mget().Key("key1", "key2").Build()), &xs)

设计考量

这个解决方案有几个优点：

1. 类型安全：使用了 Go 的泛型特性，确保类型安全
2. 清晰明确：功能单一且明确，不会产生歧义
3. 错误处理完善：正确处理了 Redis 返回的 nil 值情况
4. 性能考虑：预先分配了切片空间，避免多次内存分配

相比其他数据库库（如 sqlx）提供的复杂扫描功能，这个解决方案更加轻量且专注于 Redis 特定场景的需求。它避免了使用反射包带来的复杂性和潜在的性能开销，同时提供了足够的灵活性来满足大多数使用场景。

实际应用

在实际开发中，这个辅助函数可以大大简化从 Redis 获取并解码多个 JSON 数据的流程。开发者不再需要手动遍历结果数组并对每个元素单独解码，减少了样板代码的数量，提高了代码的可读性和可维护性。

这个改进体现了 Redis/Rueidis 项目对开发者体验的重视，以及在不牺牲性能的前提下提供更友好 API 的设计理念。