Redis 与缓存 / 系统课时
处理损坏的 AOF 文件
处理损坏的 AOF 文件
本课解决“Redis 因 AOF 尾部不完整或格式错误无法启动”的问题。完成后,你能区分可容忍的尾部截断与中部损坏,并在完整备份后使用 redis-check-aof 检查和修复。
学习目标
- 根据启动日志判断 AOF 损坏类型
- 使用检查工具定位错误文件和偏移
- 在可接受数据损失范围内执行修复并验证
先判断故障类型
进程崩溃或磁盘写满可能让最后一条命令只写入一部分,这属于尾部截断。启用 aof-load-truncated yes 时,Redis 可以在部分尾部截断场景中丢弃不完整结尾并继续加载,同时记录警告。
若无效内容出现在文件中部,或 manifest 与文件集合不一致,Redis 可能拒绝启动。不要看到失败就立即执行 --fix,因为修复可能截掉错误位置之后的内容,错误越靠前,潜在数据损失越大。
安全处理顺序

处理顺序应固定为:停止实例、复制原始文件、只读检查、评估损失、执行修复、隔离验证、再恢复服务。Redis 7 及以上还要保留整个 appendonlydir 和 manifest,不能只备份报错的单个文件。
只读检查 AOF
以下示例以 Redis 7 及以上的 manifest 为入口。工具版本应与 Redis 服务版本匹配,路径按实际 dir 和 appenddirname 修改。
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"预期结果示例:
检查工具报告损坏文件、可正常解析到的偏移和剩余差异,并以非零状态结束。不同版本和损坏位置的具体文案会不同,应以工具报告的文件名和偏移为准。Redis 6 及更早的单文件 AOF,应把参数改为实际的 appendonly.aof。
执行修复
确认备份完整且不可变,并接受错误位置之后可能被截断,再执行修复。工具通常会要求交互确认。
AOF_MANIFEST=/var/lib/redis/appendonlydir/appendonly.aof.manifest
redis-check-aof --fix "$AOF_MANIFEST"预期结果示例:
工具显示修复前后大小并请求确认。
确认后截断损坏内容,最终报告修复完成。输出会随版本和损坏类型变化。若工具提示 manifest 记录与文件集合不一致,应先查明缺失文件来源,不要继续手工删除记录或伪造文件。
启动并验证
修复后先记录目录清单和校验和,再启动隔离实例或维护中的原实例,检查持久化状态与关键数据。
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预期输出:
<SHA256> /var/lib/redis/appendonlydir/<FILE>
aof_enabled:1
aof_last_write_status:ok
(integer) <KEY_COUNT>哈希、文件名和键数量均为动态值。应把 <KEY_COUNT> 与最近备份、监控记录或业务数据库对账,确认实际丢失范围。
修复后的根因处理
若根因是磁盘满,应先扩容或清理并设置容量告警;若是文件系统或硬件错误,应迁移数据盘;若频繁异常关机,则要检查宿主机、容器退出策略和电源保护。
只修复文件而不处理根因,故障仍会再次发生。恢复服务后还应重新生成可靠备份,并安排一次完整恢复演练。