如何在 Go 中为 Redis 键设置过期时间（TTL）-Golang-PHP中文网

如何在 Go 中为 Redis 键设置过期时间（TTL）

本文详解如何在 Go 应用中为 Redis 键设置 1 小时自动过期，涵盖 go-redis 和 Redigo 两大主流客户端的正确实现方式，并提供可直接复用的代码示例与关键注意事项。

本文详解如何在 go 应用中为 redis 键设置 1 小时自动过期，涵盖 `go-redis` 和 `redigo` 两大主流客户端的正确实现方式，并提供可直接复用的代码示例与关键注意事项。

在 Go 后端开发中，将用户 Token 等临时数据存入 Redis 是常见实践。但若未显式设置过期时间（TTL），这些键将永久驻留，不仅浪费内存，还可能引发安全与一致性风险。值得注意的是：Redis 的哈希（Hash）类型本身不支持整体 TTL——即你无法直接对一个 HMSET 写入的整个 Hash 结构设置过期时间；TTL 只能作用于 Key 级别。因此，无论使用 HMSET 还是 HSET，都必须为该 Hash 的 key（如 "token:abc123"）单独设置过期。

✅ 推荐方案：使用 `go-redis`（现代、活跃、API 清晰）

go-redis 是当前最主流的 Redis 客户端，其设计原生支持在写入时一并指定 TTL：

import "time"

// 方式1：写入后立即设置过期（适用于已存在的 key）
_, err := redisClient.Expire("token:abc123", 1*time.Hour).Result()
if err != nil {
    log.Printf("Failed to set expiry: %v", err)
}

// 方式2：一步完成写入 + 过期（更高效，推荐用于新 key）
// 注意：Set() 仅适用于 string 类型值
_, err := redisClient.Set("token:abc123", "some-string-value", 1*time.Hour).Result()

// 方式3：对 Hash 类型，需分两步（HMSET + EXPIRE），因 go-redis 无原子 HMSET+EXPIRE 命令
err := redisClient.HMSet("token:abc123", map[string]interface{}{
    "user_id": 123,
    "issued_at": time.Now().Unix(),
    "scope": "read:profile",
}).Err()
if err != nil {
    log.Printf("HMSET failed: %v", err)
    return
}
_, err = redisClient.Expire("token:abc123", 1*time.Hour).Result() // 关键：为 hash key 设置 TTL

⚠️ Redigo 用户注意：必须手动调用 `EXPIRE`

Redigo 不提供高层封装方法，需显式执行 EXPIRE 命令（注意：不是 EXPIREAT）：

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

import "github.com/gomodule/redigo/redis"

// 先 HMSET 写入 Hash
_, err := redisCon.Do("HMSET", redis.Args{}.Add("token:abc123").AddFlat(&dataStruct)...)
if err != nil {
    log.Printf("HMSET failed: %v", err)
    return
}

// 再为该 key 设置 3600 秒（1 小时）过期
_, err = redisCon.Do("EXPIRE", "token:abc123", 3600)
if err != nil {
    log.Printf("EXPIRE failed: %v", err)
    return
}