K8s中Redis StatefulSet生成备份后无法访问旧键的问题

一、确认旧数据是否在backup前缀键中 #

1. 进入Redis容器终端：

   kubectl exec -it test-redis-0 -- redis-cli -a admin
   

2. 列出所有带backup前缀的键：

   KEYS "backup*"
   

3. 对比备份键与旧键的内容，比如原键是user_hash，查看备份键内容：

   # 示例：如果备份键是backup1:user_hash
   HGETALL backup1:user_hash
   # 若为流数据，使用
   XRANGE backup1:user_stream - +
   

   以此验证旧数据是否存在于备份键中。

二、恢复旧键访问（无数据丢失） #

如果确认备份键包含旧数据，可批量恢复：

方法1：用Lua脚本批量重命名恢复 #

在Redis客户端中执行以下Lua脚本，自动将备份键恢复为原键名（原键已存在时会添加时间戳后缀避免覆盖）：

local keys = redis.call('KEYS', 'backup*')
for _, key in ipairs(keys) do
   local original_key = string.sub(key, string.find(key, ':') + 1)
   if redis.call('EXISTS', original_key) == 0 then
       redis.call('RENAME', key, original_key)
   else
       redis.call('RENAME', key, original_key .. '_backup_' .. redis.call('TIME')[1])
   end
end
return #keys

方法2：若为RDB文件备份（如backup1.rdb） #

如果backup*是RDB备份文件而非键，按以下步骤恢复：

1. 停止Redis实例：

   kubectl scale statefulset test-redis --replicas=0
   

2. 用临时容器挂载数据卷查看文件：

   kubectl run -it --rm temp-pod --image=busybox --volume claimName=redis-data-test-redis-0 --mount-path=/data
   

3. 在临时容器内替换RDB文件：

   cp /data/backup1.rdb /data/dump.rdb
   chmod 644 /data/dump.rdb
   

4. 重启Redis：

   kubectl scale statefulset test-redis --replicas=1
   

三、排查自动生成backup键的原因 #

官方Redis镜像默认不会自动生成这类备份键，优先排查以下点：

• 业务代码逻辑：检查是否有定期备份旧键、重命名为backup*的代码逻辑。
• 集群定时任务：查看K8s中是否有CronJob或脚本在自动备份Redis键。
• 快照触发频率：你的配置中--save 900 1和--save 30 2触发快照过于频繁，可能引发异常，建议调整为更合理的策略。

四、优化Redis配置避免后续问题 #

修改StatefulSet的Redis启动参数，调整快照策略为更合理的阈值：

args: ["--requirepass", "admin", "--appendonly", "yes", "--save", "3600", "100", "--save", "300", "1000",
      "--appendfsync", "everysec", "--stop-writes-on-bgsave-error", "no"]

（说明：1小时内有100次写入、5分钟内有1000次写入时触发快照，减少不必要的IO操作）

内容的提问来源于stack exchange，提问作者Raisul