Redis自动RDB备份脚本详解

Redis自动RDB备份远不止简单调用bgsave命令，关键在于解决异步执行带来的“假成功”陷阱：BGSAVE返回OK仅表示触发开始，不保证文件已写入完成；crontab环境缺失、路径硬编码、缺乏状态校验和超时保护，极易导致备份静默失败、生成空文件或残留旧数据。本文详解一套生产级脚本方案——动态获取RDB路径、等待rdb_last_save_time更新确认落地、校验文件非空、添加timeout防卡死、自动压缩与7天轮转清理，并强调crontab需显式配置PATH和完整日志，直击线上备份不可靠的核心痛点，让每一次备份真正可验证、可追溯、可信赖。

Redis 自动 RDB 备份不能只靠 crontab 直接调用 redis-cli bgsave —— 因为 BGSAVE 是异步命令，crontab 无法感知执行是否成功、RDB 文件是否真的生成、旧备份是否该清理。

为什么 redis-cli bgsave 在 crontab 里容易“看似运行实则失效”

crontab 执行环境缺失 PATH 和 HOME，redis-cli 可能根本找不到；更关键的是：BGSAVE 返回 OK 仅表示“已触发”，不代表 RDB 写入完成。若脚本立即检查文件时间或做压缩，大概率拿到空文件或上一轮残留。

• 必须等待 redis-cli info persistence | grep rdb_last_save_time 确认写入完成时间戳更新
• 建议用 redis-cli config get dir 动态读取实际 dbfilename 路径，而非硬编码 /var/lib/redis/dump.rdb
• 避免在 save 过程中被 kill -9 或 OOM 终止 —— 加 timeout 300 防卡死

一个安全可用的自动备份脚本（含状态校验与轮转）

以下脚本保存为 /usr/local/bin/redis-rdb-backup.sh，需 chmod +x：

#!/bin/bash
REDIS_CLI="/usr/bin/redis-cli"
REDIS_HOST="127.0.0.1"
REDIS_PORT="6379"
BACKUP_DIR="/data/redis-backup"
KEEP_DAYS=7
<h1>获取实际 RDB 路径</h1><p>RDB_DIR=$($REDIS_CLI -h $REDIS_HOST -p $REDIS_PORT config get dir | tail -n 1)
RDB_NAME=$($REDIS_CLI -h $REDIS_HOST -p $REDIS_PORT config get dbfilename | tail -n 1)
RDB_PATH="$RDB_DIR/$RDB_NAME"</p><h1>触发 BGSAVE</h1><p>if ! $REDIS_CLI -h $REDIS_HOST -p $REDIS_PORT bgsave 2>/dev/null | grep -q "OK"; then
echo "[$(date)] BGSAVE failed" >&2
exit 1
fi</p><h1>等待写入完成（最多等 60 秒）</h1><p>for i in $(seq 1 60); do
LAST_SAVE=$($REDIS_CLI -h $REDIS_HOST -p $REDIS_PORT info persistence | grep rdb_last_save_time | cut -d: -f2 | tr -d '\r\n')
if [[ "$LAST_SAVE" =~ ^[0-9]+$ ]] && [ $(($(date +%s) - LAST_SAVE)) -lt 300 ]; then
break
fi
sleep 1
done</p><h1>检查 RDB 文件是否存在且非空</h1><p>if [[ ! -s "$RDB_PATH" ]]; then
echo "[$(date)] RDB file missing or empty: $RDB_PATH" >&2
exit 1
fi</p><h1>复制并打时间戳</h1><p>mkdir -p "$BACKUP<em>DIR"
TS=$(date +"%Y%m%d</em>%H%M%S")
cp "$RDB_PATH" "$BACKUP<em>DIR/dump</em>$TS.rdb"
gzip "$BACKUP<em>DIR/dump</em>$TS.rdb"</p><h1>清理 7 天前的备份</h1><p>find "$BACKUP<em>DIR" -name "dump</em>*.rdb.gz" -mtime +$KEEP_DAYS -delete</p>

注意：$RDB_DIR 和 $RDB_NAME 必须用 tail -n 1 去掉 config 输出的 key 行，否则路径拼接会出错。

crontab 正确配置方式（带环境与日志）

直接写 * */6 * * * redis-cli bgsave 是无效的。应使用完整路径+环境变量：

# 编辑 root 的 crontab：crontab -e
SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin
0 */6 * * * /usr/local/bin/redis-rdb-backup.sh >> /var/log/redis-backup.log 2>&1

• 必须显式设置 PATH，否则 redis-cli 找不到
• 日志重定向到文件，方便排查 config get dir 权限拒绝、连接超时等静默失败
• 不要用 */6 分钟级备份 —— BGSAVE 频繁触发会导致 fork 开销剧增，建议至少 0 */4（每 4 小时）

真正难的不是调用 BGSAVE，而是确认它确实落地了。很多线上事故源于备份脚本返回 0 却没生成新文件 —— 一定要校验 rdb_last_save_time 和文件 -s 大小，缺一不可。

本篇关于《Redis自动RDB备份脚本详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于数据库的相关知识，请关注golang学习网公众号！