Redis 与缓存 / 系统课时

处理 AOF 尾部截断

处理 AOF 尾部截断

异常关机、磁盘写满或写入中断可能让 AOF 最后一条命令只写入一部分。处理这类故障的关键不是立即执行修复命令,而是先区分单纯的尾部截断与文件中段损坏,再决定让 Redis 自动丢弃尾部、人工检查还是保留现场进一步恢复。

学习目标

  • 识别 AOF 尾部截断与中段损坏的不同风险
  • 理解 aof-load-truncated 对启动行为的影响
  • 按备份、检查、修复、启动验证的顺序安全处置 AOF

先确认是不是尾部截断

AOF 是按写命令持续追加的。进程或主机在一次追加尚未完整落盘时退出,文件末尾可能只剩半条 RESP 命令。前面的内容仍然完整,因此这种情况与“文件中间出现随机损坏”有本质区别。

典型的尾部截断发生在文件末端,恢复损失通常局限于最后一个未完整写入的命令及尚未持久化的数据。若错误位于文件中段,则后面的字节即使仍然存在,也不能简单假定可以安全连续重放。

AOF 尾部截断的判断与处置路径

检查自动截断策略

较新的 Redis 版本可以在检测到最后一条 AOF 命令不完整时丢弃这段尾部并继续加载。是否允许这一行为由 aof-load-truncated 控制。

查询实例配置:

bash
redis-cli CONFIG GET aof-load-truncated

预期输出

text
aof-load-truncated
<VALUE>

<VALUE> 是实例当前配置,常见值为 yes 或 no。如果为 yes,符合尾部截断条件时 Redis 可以截去不完整尾部并继续启动,同时在日志中留下警告;如果为 no,Redis 会停止加载,让操作者先处理文件。

自动截断强调的是可用性优先,并不代表没有数据损失。被丢弃的最后一个不完整命令无法恢复,此外实际 RPO 还受到 appendfsync 策略以及故障前尚未持久化数据的影响。

人工处理前先保存现场

如果 Redis 无法正常加载,或者你不能确认问题只发生在尾部,不要直接对唯一一份 AOF 使用 --fix。先停止 Redis,并复制整个持久化目录,包括多段 AOF 的 manifest、base 和 incr 文件。

下面是备份目录的通用做法,<PATH> 替换为实际 Redis 数据目录:

bash
cp -a <PATH> <PATH>.before-aof-repair

预期结果

text
命令无输出时通常表示复制完成;<PATH>.before-aof-repair 保存修复前的完整现场副本

备份整个目录而不是只复制一个看起来异常的增量文件,是因为 Redis 7.0 以后的多段 AOF 还依赖 manifest 描述文件之间的有效组合关系。

先检查再决定是否修复

redis-check-aof 可以先在不带 --fix 的情况下检查目标 AOF。实际检查对象应根据当前 Redis 版本、manifest 和启动日志定位,不要凭文件名任选一个旧的增量文件。

bash
redis-check-aof <PATH>

预期结果

text
工具报告 AOF 是否有效;发现异常时会给出与损坏位置相关的诊断信息,具体偏移量和文本取决于实际文件

如果确认只有末尾是不完整写入,并且已有现场备份,才考虑让 Redis 的自动截断策略处理,或在明确评估损失后执行人工修复。对于中段损坏,应先分析异常偏移附近的数据,判断还能否人工恢复,而不是直接把后续所有内容截掉。

需要使用自动修复工具时,命令形式为:

bash
redis-check-aof --fix <PATH>

预期结果

text
工具会报告检测到的问题以及修复结果;被截断或删除的数据范围取决于实际损坏位置

这一步会改变文件,因此只能对已备份的工作副本或确认可修改的现场执行。

重启后验证恢复边界

文件能够通过检查并不等于业务数据已经正确恢复。重新启动 Redis 后,需要先确认持久化状态,再核对故障前后最关键的数据键和业务计数。

bash
redis-cli INFO persistence

预期输出

text
# Persistence
loading:0
rdb_last_bgsave_status:<VALUE>
aof_enabled:<VALUE>
aof_last_write_status:<VALUE>

具体字段和值会随 Redis 版本和持久化配置变化;核心检查点是实例已经结束加载、AOF 状态没有继续报错,并且业务侧的数据校验与预期恢复点一致。

处理 AOF 尾部截断时,应把“能启动”和“恢复正确”视为两个门槛:先保护原始文件,再判断损坏位置,只对明确的尾部问题采用截断策略,最后通过 Redis 状态和业务数据共同确认实际恢复结果。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

处理 AOF 尾部截断

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通