Redis 与缓存 / 系统课时
检查并修复持久化文件
检查并修复持久化文件
当 Redis 因 RDB 或 AOF 文件异常无法启动时,最危险的动作不是“修得慢”,而是直接覆盖原文件。本课建立一条可回退的处理链:先确认文件位置并停止进一步改写,再完整备份现场,用与故障实例匹配的检查工具判断损坏类型,最后只在明确损失范围后执行修复或恢复。
学习目标
- 能定位当前实例实际使用的 RDB 与 AOF 文件
- 能使用与故障实例版本匹配的检查工具判断文件完整性,并区分单文件 AOF 与 Redis 7+ 多段 AOF
- 能在保留原始证据的前提下完成受控修复,并验证恢复结果
先确认文件位置并停止进一步改写
不要凭默认路径寻找文件。先从运行中的同版本实例或现有配置中确认 dir、dbfilename、appenddirname 和 appendfilename。Redis 7 及之后采用多段 AOF,BASE、INCR 与 manifest 共同组成恢复链,因此现场备份不能只复制某一个 .aof 文件。:contentReference[oaicite:0]{index=0}
redis-cli CONFIG GET dir dbfilename appenddirname appendfilename预期输出
dir
<PATH>
dbfilename
dump.rdb
appenddirname
appendonlydir
appendfilename
appendonly.aof实际路径和文件名可能不同;如果故障实例已经无法启动,就从其 redis.conf 或启动参数读取同样的配置。确认位置后先停止故障实例,避免后台保存、AOF 追加或重写继续改变现场。
先做只读备份再检查
RDB 是单文件快照。Redis 7+ 的 AOF 则由 manifest 以及它引用的 BASE、INCR 等文件共同组成。由于 AOF 重写期间文件集合可能变化,故障现场应先停止实例,再完整复制 RDB 文件和 AOF 目录,并把备份放到不同目录。:contentReference[oaicite:1]{index=1}
mkdir -p <PATH>/backup
cp -a <PATH>/dump.rdb <PATH>/backup/dump.rdb.before-repair
cp -a <PATH>/appendonlydir <PATH>/backup/appendonlydir.before-repair预期结果
命令成功时通常没有标准输出,退出码为 0;<PATH>/backup/ 下应存在 dump.rdb.before-repair 和 appendonlydir.before-repair。
用匹配版本的检查工具判断损坏类型
redis-check-rdb 用于检查 RDB 结构和校验信息,不提供通用的“自动修复 RDB”能力。redis-check-aof 用于检查 AOF,但其参数和支持的输入形式应以与故障实例匹配版本的工具为准。Redis 7+ 使用多段 AOF,manifest 负责描述 BASE、INCR 等文件,因此“检查某个 AOF 文件通过”不能直接等同于“整套 AOF 恢复链已经验证”。Redis 官方文档也将 AOF 文件检查与整套持久化文件的加载验证区分开来。:contentReference[oaicite:2]{index=2}
先查看实际工具能力,再执行只读检查;不要把 Redis 7+ 的 manifest 路径直接当成普通单文件 AOF 去修复。
redis-check-rdb <PATH>/dump.rdb
redis-check-aof --help
redis-check-aof <PATH>/appendonlydir/<FILE>预期输出
RDB 正常时通常包含:
Checksum OK
RDB looks OK
redis-check-aof --help 应列出当前版本实际支持的参数;针对单个 AOF 文件的检查成功时,应返回成功状态且不报告格式错误。<FILE> 必须替换为现场实际存在、且符合当前工具支持范围的 AOF 文件。对于 Redis 7+ 多段 AOF,重点不是只检查一个文件,而是确认 manifest、BASE、INCR 文件之间的引用关系完整,并最终验证整套文件能被目标 Redis 正常加载。对于旧式单文件 AOF,则直接检查实际 .aof 文件。不同 Redis 主版本的工具行为可能不同,不能拿明显不匹配的二进制处理新格式文件。
只在确认损失范围后修复 AOF
AOF 尾部因宕机或磁盘写满而出现半条命令时,较新的 Redis 通常可以在 aof-load-truncated 开启时丢弃最后一个不完整命令继续加载;只有确实无法直接恢复,或需要人工确认截断范围时,才进入 --fix 流程。官方文档明确建议先不带 --fix 检查,再决定是否修复。:contentReference[oaicite:3]{index=3}
redis-check-aof --fix <PATH>/appendonlydir/<FILE>预期结果
工具会报告发现的 AOF 问题以及拟执行的修改或截断范围;命令完成后应返回成功状态。随后需要再次执行只读检查,并用整套持久化文件启动目标 Redis 验证恢复结果。<FILE> 必须是当前版本工具支持修复的具体 AOF 文件,不要把多段 AOF 的 manifest 直接作为 --fix 的普通 AOF 文件处理。RDB 检查失败时,不要寻找不存在的“通用 RDB 自动修复”步骤。更稳妥的路径是保留坏文件用于分析,然后恢复最近一份已知良好的 RDB,或从健康副本重新生成数据。
重启后验证的不只是 PING
文件检查通过只说明持久化数据在检查工具眼中可解析,不代表业务数据已经完整。恢复后至少确认 Redis 可连接、持久化状态没有继续报错,并抽查关键键数量或业务不变量;如果数据依赖模块,还要确认对应模块已加载,否则文件可读仍可能在真实启动时失败。
redis-cli PING
redis-cli INFO persistence预期输出
PONG
# INFO persistence 中,启用的持久化方式对应状态应为成功;例如 rdb_last_bgsave_status:ok 或 aof_last_write_status:ok。具体字段取决于实例启用的持久化方式。只有文件校验、Redis 启动、持久化状态和关键业务数据四层都通过,才能把这次修复视为完成;对于 Redis 7+ 多段 AOF,还应把 manifest、BASE、INCR 文件的完整加载验证作为同一次恢复验收的一部分。