Redis 与缓存 / 系统课时

处理损坏的 AOF 文件

处理损坏的 AOF 文件

本课解决“Redis 因 AOF 尾部不完整或格式错误无法启动”的问题。完成后,你能区分可容忍的尾部截断与中部损坏,并在完整备份后使用 redis-check-aof 检查和修复。

学习目标

  • 根据启动日志判断 AOF 损坏类型
  • 使用检查工具定位错误文件和偏移
  • 在可接受数据损失范围内执行修复并验证

先判断故障类型

进程崩溃或磁盘写满可能让最后一条命令只写入一部分,这属于尾部截断。启用 aof-load-truncated yes 时,Redis 可以在部分尾部截断场景中丢弃不完整结尾并继续加载,同时记录警告。

若无效内容出现在文件中部,或 manifest 与文件集合不一致,Redis 可能拒绝启动。不要看到失败就立即执行 --fix,因为修复可能截掉错误位置之后的内容,错误越靠前,潜在数据损失越大。

安全处理顺序

AOF 损坏检查与修复流程

处理顺序应固定为:停止实例、复制原始文件、只读检查、评估损失、执行修复、隔离验证、再恢复服务。Redis 7 及以上还要保留整个 appendonlydir 和 manifest,不能只备份报错的单个文件。

只读检查 AOF

以下示例以 Redis 7 及以上的 manifest 为入口。工具版本应与 Redis 服务版本匹配,路径按实际 dir 和 appenddirname 修改。

bash
AOF_DIR=/var/lib/redis/appendonlydir
AOF_MANIFEST="$AOF_DIR/appendonly.aof.manifest"
BACKUP_DIR=/backup/appendonlydir-before-repair

sudo systemctl stop redis-server
sudo cp -a "$AOF_DIR" "$BACKUP_DIR"
redis-check-aof "$AOF_MANIFEST"

预期结果示例:

text
检查工具报告损坏文件、可正常解析到的偏移和剩余差异,并以非零状态结束。

不同版本和损坏位置的具体文案会不同,应以工具报告的文件名和偏移为准。Redis 6 及更早的单文件 AOF,应把参数改为实际的 appendonly.aof。

执行修复

确认备份完整且不可变,并接受错误位置之后可能被截断,再执行修复。工具通常会要求交互确认。

bash
AOF_MANIFEST=/var/lib/redis/appendonlydir/appendonly.aof.manifest
redis-check-aof --fix "$AOF_MANIFEST"

预期结果示例:

text
工具显示修复前后大小并请求确认。
确认后截断损坏内容,最终报告修复完成。

输出会随版本和损坏类型变化。若工具提示 manifest 记录与文件集合不一致,应先查明缺失文件来源,不要继续手工删除记录或伪造文件。

启动并验证

修复后先记录目录清单和校验和,再启动隔离实例或维护中的原实例,检查持久化状态与关键数据。

bash
sudo sha256sum /var/lib/redis/appendonlydir/*
sudo systemctl start redis-server

REDIS_PORT=6379
redis-cli -p "$REDIS_PORT" INFO persistence | grep -E "aof_enabled|aof_last_write_status"
redis-cli -p "$REDIS_PORT" DBSIZE

预期输出:

text
<SHA256>  /var/lib/redis/appendonlydir/<FILE>
aof_enabled:1
aof_last_write_status:ok
(integer) <KEY_COUNT>

哈希、文件名和键数量均为动态值。应把 <KEY_COUNT> 与最近备份、监控记录或业务数据库对账,确认实际丢失范围。

修复后的根因处理

若根因是磁盘满,应先扩容或清理并设置容量告警;若是文件系统或硬件错误,应迁移数据盘;若频繁异常关机,则要检查宿主机、容器退出策略和电源保护。

只修复文件而不处理根因,故障仍会再次发生。恢复服务后还应重新生成可靠备份,并安排一次完整恢复演练。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理损坏的 AOF 文件

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

登录哪都通