Redis 与缓存 / 系统课时
排查持久化写入失败
排查持久化写入失败
RDB 保存失败或 AOF 无法追加时,表面现象可能只是写命令报错、后台任务失败或重启后的数据风险上升。本课按“状态证据→磁盘与文件系统→权限→fork 与内存→后台任务复验”的顺序定位,避免一看到错误就盲目关闭持久化保护。
学习目标
- 能从
INFO persistence区分 RDB、AOF 和后台重写异常 - 能检查空间、inode、目录权限、只读挂载以及 fork 与内存压力
- 能在修复根因后重新触发持久化并确认状态恢复
先判断是哪条持久化链路失败
先保留错误现场,再查看 Redis 自己记录的持久化状态。RDB 重点看最近一次后台保存结果,AOF 重点看最近写入和重写结果,同时确认后台任务是否仍在运行。不要只依据客户端的一条报错判断根因。
redis-cli INFO persistence
redis-cli CONFIG GET stop-writes-on-bgsave-error预期输出
rdb_bgsave_in_progress:<VALUE>
rdb_last_bgsave_status:ok|err
aof_enabled:<VALUE>
aof_rewrite_in_progress:<VALUE>
aof_last_bgrewrite_status:ok|err
aof_last_write_status:ok|err
stop-writes-on-bgsave-error
yes字段实际值取决于当前故障。stop-writes-on-bgsave-error yes 主要用于 RDB 后台保存失败时阻止部分写入,以降低继续接受写请求却无法落盘的风险,不是 AOF 写入失败的统一开关。未找到根因前,不要直接改成 no。

先排除磁盘空间和 inode 耗尽
RDB 保存需要创建临时快照并完成最终文件替换,AOF 追加和重写同样需要可写空间。磁盘还有少量剩余容量并不代表一定能写,还要同时看 inode;AOF 重写在构建新文件时尤其需要额外空间。
df -h <PATH>
df -i <PATH>预期输出
Filesystem Size Used Avail Use% Mounted on
<VALUE> <VALUE> <VALUE> <VALUE> <VALUE> <PATH>
Filesystem Inodes IUsed IFree IUse% Mounted on
<VALUE> <VALUE> <VALUE> <VALUE> <VALUE> <PATH>如果 Avail 接近 0 或 IFree 为 0,应先释放空间或扩容,再重新验证。不要优先删除当前唯一的 RDB、AOF manifest 或增量文件来“腾空间”,否则可能把可恢复故障变成数据丢失。
检查目录权限和文件系统状态
Redis 进程需要对配置中的 dir 以及 AOF 子目录拥有正确的写权限。即使单个文件可写,只要父目录不可写,也可能无法创建临时文件或完成原子重命名;文件系统被挂载为只读时,修改 Unix 权限也无法解决。
ls -ld <PATH>
test -w <PATH> && echo writable || echo not-writable
findmnt -no TARGET,OPTIONS <PATH>预期输出
drwx<VALUE> <VALUE> <VALUE> <VALUE> <PATH>
writable
<PATH> <VALUE>,rw,<VALUE>如果显示 not-writable,继续核对 Redis 实际运行用户、目录属主和权限。若挂载选项包含 ro,应进一步检查内核或存储层 I/O 错误,先恢复文件系统可写状态。反复执行 chmod 777 既不能修复只读挂载,也会扩大安全风险。
再看 fork 和内存压力
BGSAVE 与 BGREWRITEAOF 都需要创建后台子进程。fork 并不意味着立即复制全部 Redis 内存,但写时复制会带来额外内存压力;系统可用内存不足、提交策略不合适或容器限制过紧时,后台任务可能无法启动或执行失败。
redis-cli INFO memory
redis-cli INFO persistence
sysctl vm.overcommit_memory预期输出
used_memory:<VALUE>
used_memory_rss:<VALUE>
rdb_last_cow_size:<VALUE>
aof_last_cow_size:<VALUE>
vm.overcommit_memory = <VALUE>这里不能只盯着 vm.overcommit_memory 一个值。应结合 Redis 日志、可用内存、容器内存限制和 COW 峰值判断是否存在 fork 或后台子进程资源问题,再决定是否调整系统参数。
核对后台任务并主动复验
先确认当前是“正在执行”“等待执行”还是“执行后失败”,重点查看 rdb_bgsave_in_progress、rdb_last_bgsave_status、aof_rewrite_in_progress、aof_rewrite_scheduled 以及 AOF 最近写入和重写状态。
redis-cli INFO persistence | grep -E '^(rdb_bgsave_in_progress|rdb_last_bgsave_status|aof_rewrite_in_progress|aof_rewrite_scheduled|aof_last_bgrewrite_status|aof_last_write_status):'预期输出
rdb_bgsave_in_progress:<VALUE>
rdb_last_bgsave_status:ok|err
aof_rewrite_in_progress:<VALUE>
aof_rewrite_scheduled:<VALUE>
aof_last_bgrewrite_status:ok|err
aof_last_write_status:ok|err如果状态长期停在进行中,应结合 Redis 进程、磁盘 I/O 和日志继续定位;如果很快回到 err,优先读取对应时间点的日志,因为常见直接证据包括 Permission denied、No space left on device、Read-only file system 或 fork 失败。
根因修复后不要只等待下一次自动任务。RDB 使用 BGSAVE 做受控复验;AOF 需要验证追加状态时检查 aof_last_write_status,需要验证重写链路时再执行 BGREWRITEAOF。
redis-cli BGSAVE
redis-cli INFO persistence | grep -E '^(rdb_bgsave_in_progress|rdb_last_bgsave_status):'预期输出
Background saving started
rdb_bgsave_in_progress:0
rdb_last_bgsave_status:okBGSAVE 返回成功只表示后台任务已启动,最终仍要看持久化状态。AOF 重写复验时,应确认 aof_rewrite_in_progress:0 且 aof_last_bgrewrite_status:ok;最后再做一次业务允许的测试写入,确认客户端写成功且持久化状态没有重新转为 err,才算真正恢复。