Redis 与缓存 / 系统课时
处理 AOF 尾部截断
处理 AOF 尾部截断
异常关机、磁盘写满或写入中断可能让 AOF 最后一条命令只写入一部分。处理这类故障的关键不是立即执行修复命令,而是先区分单纯的尾部截断与文件中段损坏,再决定让 Redis 自动丢弃尾部、人工检查还是保留现场进一步恢复。
学习目标
- 识别 AOF 尾部截断与中段损坏的不同风险
- 理解
aof-load-truncated对启动行为的影响 - 按备份、检查、修复、启动验证的顺序安全处置 AOF
先确认是不是尾部截断
AOF 是按写命令持续追加的。进程或主机在一次追加尚未完整落盘时退出,文件末尾可能只剩半条 RESP 命令。前面的内容仍然完整,因此这种情况与“文件中间出现随机损坏”有本质区别。
典型的尾部截断发生在文件末端,恢复损失通常局限于最后一个未完整写入的命令及尚未持久化的数据。若错误位于文件中段,则后面的字节即使仍然存在,也不能简单假定可以安全连续重放。

检查自动截断策略
较新的 Redis 版本可以在检测到最后一条 AOF 命令不完整时丢弃这段尾部并继续加载。是否允许这一行为由 aof-load-truncated 控制。
查询实例配置:
redis-cli CONFIG GET aof-load-truncated预期输出
aof-load-truncated
<VALUE><VALUE> 是实例当前配置,常见值为 yes 或 no。如果为 yes,符合尾部截断条件时 Redis 可以截去不完整尾部并继续启动,同时在日志中留下警告;如果为 no,Redis 会停止加载,让操作者先处理文件。
自动截断强调的是可用性优先,并不代表没有数据损失。被丢弃的最后一个不完整命令无法恢复,此外实际 RPO 还受到 appendfsync 策略以及故障前尚未持久化数据的影响。
人工处理前先保存现场
如果 Redis 无法正常加载,或者你不能确认问题只发生在尾部,不要直接对唯一一份 AOF 使用 --fix。先停止 Redis,并复制整个持久化目录,包括多段 AOF 的 manifest、base 和 incr 文件。
下面是备份目录的通用做法,<PATH> 替换为实际 Redis 数据目录:
cp -a <PATH> <PATH>.before-aof-repair预期结果
命令无输出时通常表示复制完成;<PATH>.before-aof-repair 保存修复前的完整现场副本备份整个目录而不是只复制一个看起来异常的增量文件,是因为 Redis 7.0 以后的多段 AOF 还依赖 manifest 描述文件之间的有效组合关系。
先检查再决定是否修复
redis-check-aof 可以先在不带 --fix 的情况下检查目标 AOF。实际检查对象应根据当前 Redis 版本、manifest 和启动日志定位,不要凭文件名任选一个旧的增量文件。
redis-check-aof <PATH>预期结果
工具报告 AOF 是否有效;发现异常时会给出与损坏位置相关的诊断信息,具体偏移量和文本取决于实际文件如果确认只有末尾是不完整写入,并且已有现场备份,才考虑让 Redis 的自动截断策略处理,或在明确评估损失后执行人工修复。对于中段损坏,应先分析异常偏移附近的数据,判断还能否人工恢复,而不是直接把后续所有内容截掉。
需要使用自动修复工具时,命令形式为:
redis-check-aof --fix <PATH>预期结果
工具会报告检测到的问题以及修复结果;被截断或删除的数据范围取决于实际损坏位置这一步会改变文件,因此只能对已备份的工作副本或确认可修改的现场执行。
重启后验证恢复边界
文件能够通过检查并不等于业务数据已经正确恢复。重新启动 Redis 后,需要先确认持久化状态,再核对故障前后最关键的数据键和业务计数。
redis-cli INFO persistence预期输出
# Persistence
loading:0
rdb_last_bgsave_status:<VALUE>
aof_enabled:<VALUE>
aof_last_write_status:<VALUE>具体字段和值会随 Redis 版本和持久化配置变化;核心检查点是实例已经结束加载、AOF 状态没有继续报错,并且业务侧的数据校验与预期恢复点一致。
处理 AOF 尾部截断时,应把“能启动”和“恢复正确”视为两个门槛:先保护原始文件,再判断损坏位置,只对明确的尾部问题采用截断策略,最后通过 Redis 状态和业务数据共同确认实际恢复结果。