如何在 Go 中使用 Redigo 获取 Redis 的所有键

本文介绍如何通过 redigo 客户端在 go 中安全、高效地获取 redis 数据库中的全部键，并将其转换为字符串切片进行后续处理，同时强调生产环境中的关键注意事项。

本文介绍如何通过 redigo 客户端在 go 中安全、高效地获取 redis 数据库中的全部键，并将其转换为字符串切片进行后续处理，同时强调生产环境中的关键注意事项。

在 Go 应用中与 Redis 交互时，有时需要枚举当前数据库中的所有键（例如用于调试、清理或监控）。Redigo 提供了对 Redis 原生命令的直接支持，其中 KEYS * 是最直观的实现方式。但需注意：该操作时间复杂度为 O(N)，且会阻塞 Redis 单线程，因此严禁在生产环境的大型数据集上使用。

以下是一个完整、可运行的示例，展示如何正确调用并解析 KEYS 命令结果：

package main  import (     "fmt"     "log"     "github.com/garyburd/redigo/redis" )  func main() {     // 初始化连接池（推荐方式，避免频繁建连）     pool := &redis.Pool{         MaxIdle:     3,         IdleTimeout: 240 * time.Second,         Dial: func() (redis.Conn, error) {             c, err := redis.Dial("tcp", "localhost:6379")             if err != nil {                 return nil, err             }             // 显式选择 DB（可选，默认为 DB 0）             if _, err := c.Do("SELECT", 0); err != nil {                 c.Close()                 return nil, err             }             return c, nil         },     }     defer pool.Close()      conn := pool.Get()     defer conn.Close()      // 执行 KEYS 命令，返回 []Interface{} 类型的原始响应     reply, err := conn.Do("KEYS", "*")     if err != nil {         log.Fatal("Redis KEYS command failed:", err)     }      // 使用 redis.Strings 工具函数安全转换为 []string     // 它会自动校验响应类型（必须是 Redis bulk string 数组），并处理 nil/错误情况     keys, err := redis.Strings(reply, err)     if err != nil {         log.Fatal("Failed to parse KEYS response:", err)     }      fmt.Printf("Found %d keys:n", len(keys))     for i, key := range keys {         fmt.Printf("%d. %sn", i+1, key)     } }

⚠️ 重要注意事项：

• ✅ 开发/测试可用：KEYS * 适合本地调试或小规模数据验证；
• ❌ 生产禁用：当键数量达万级以上时，将导致 Redis 响应延迟飙升甚至超时；
• ✅ 生产替代方案：改用 SCAN 命令实现无阻塞遍历（支持游标分页、模式匹配和可控吞吐）：

  cursor := uint64(0) var allKeys []string for {     reply, err := conn.Do("SCAN", cursor, "MATCH", "*", "COUNT", 100)     if err != nil {         log.Fatal(err)     }     keys, cursor, err := parseScanReply(reply)     if err != nil {         log.Fatal(err)     }     allKeys = append(allKeys, keys...)     if cursor == 0 {         break     } }

• ? 连接池应复用并设置合理 MaxIdle 和超时参数，避免资源泄漏；
• ? redis.Strings() 是 Redigo 提供的安全类型断言工具，比手动类型断言（如 reply.([]interface{})）更健壮，能统一处理错误与空响应。

总结：掌握 KEYS 的基本用法是入门 Redis 开发的必要技能，但真正的工程实践要求开发者理解其性能边界，并主动采用 SCAN 等非阻塞方案保障系统稳定性。