Redis报MISCONF:先恢复持久化写入

Redis 还能读取缓存,程序一写入就报 MISCONF,先看完整错误中的 RDB 或 AOF 字样。此时直接重启可能丢失尚未保存的数据;关掉写入保护只会把保存故障藏起来。应保留当前进程和持久化文件,先让保存重新成功。

以下适用于自建 Linux、Redis 7 及以上的单实例排查。托管服务、主从切换和集群需要按各节点的实际身份处理,不能把命令随意发给另一个实例。应用侧先限制失败请求的无穷重试,保留一条脱敏后的完整错误和时间。

同一个错误名,先分清两条路径

沿用现有安全连接;例如在服务器本机使用已获授权的管理账户,替换地址、端口和账户名,通过提示输入密码:

redis-cli -h 127.0.0.1 -p 6379 --user your_admin --askpass

原连接使用 TLS 或隧道时保持原方式。进入 Redis 提示符后查询:

INFO server
INFO replication
INFO persistence
CONFIG GET dir dbfilename appendonly appenddirname stop-writes-on-bgsave-error

核对版本、进程、配置位置和角色,再按下表判断。遇到 NOPERM 由管理员在现有授权范围内查询,不关闭 ACL。状态字段可能随版本和启用功能不同,不能把缺少某一字段当作正常。

完整错误或状态 接下来检查什么
提到 RDB snapshots 和 stop-writes-on-bgsave-error 查看 rdb_last_bgsave_status,结合最近后台快照日志定位保存失败原因。
提到 Errors writing to the AOF file 查看 aof_enabled、aof_last_write_status,按错误尾部的操作系统原因检查实际 AOF 路径。
AOF 重写失败,但当前写入状态正常 重写状态与追加写入状态是两回事;继续按完整 MISCONF 和相同时段日志定位,不能仅凭重写失败判断当前写入被阻断。

同时使用 RDB 和 AOF 时,两条路径都要核对。记下本轮处理前的保存时间与状态,后面用于确认新一次保存确实完成。

在日志对应的数据目录找原因

dir 是 Redis 配置中的数据位置;Redis 7 的 AOF 还要结合 appenddirname。容器内路径需对应到实际挂载卷,宿主机另一个磁盘有空余不能说明这个卷可写。

使用 systemd 的服务器可读取服务日志,redis-server 必须改成这套实例的真实服务名:

sudo journalctl -u redis-server --since "30 minutes ago" --no-pager -n 150

若服务另写日志文件或运行在容器中,就查看相同实例、相同时段的日志。随后在 Linux Shell 中检查实际路径,不能把下面的占位路径原样使用:

df -h -- /实际数据目录
df -i -- /实际数据目录
ls -ld -- /实际数据目录
  • No space left on device:核对数据所在文件系统的容量与 inode,另外确认是否受磁盘配额限制。腾挪已确认可处理的其他文件或扩容,保留现有 RDB、AOF 及清单文件。
  • Permission denied:核对 Redis 进程实际运行身份、目录各级访问权限和挂载方式。只修复已确认错误的路径权限,不递归改整个系统,更不设成 777。
  • Read-only file system 或 I/O error:先处理卷、挂载或存储故障,单改目录权限不会解决问题。
  • fork 失败或 Cannot allocate memory:查看可用内存、容器限制和同机进程占用。后台快照需要创建子进程,不能在内存仍紧张时连续触发保存。

容量和 inode 的进一步检查见Linux磁盘满了怎么办。只修复日志证实的原因,避免一次改动持久化、内存和系统参数,导致无法判断哪项生效。

重新保存要看完成结果

RDB 分支:确认目录可写、容量和内存条件已恢复,评估保存对业务的负担;只有管理员确认可以启动保存,且 rdb_bgsave_in_progress、aof_rewrite_in_progress 均未显示任务进行中时,执行一次:

BGSAVE

返回已开始只说明任务被接受。随后间隔查看 INFO persistence 和日志,等待后台保存结束,确认 rdb_last_bgsave_status:ok、成功保存时间更新,且没有新的保存错误。若仍失败,按新日志继续排查,不连点重试,也不改用会阻塞服务的同步保存来碰运气。

AOF 分支:底层写入原因修复后,Redis 会重试追加写入。确认 aof_last_write_status 恢复为 ok,并检查日志不再出现同类错误;单独执行一次 RDB 快照不能证明 AOF 已经正常。保留现有持久化设置,不关闭保护、停用 AOF 或删除文件换取暂时可写。

最后回到实际业务验收

使用已确认安全的业务测试操作验证原连接的写入和读取,控制请求量,核对响应与结果后再恢复正常流量。不要用真实扣费、出队或发货操作反复试写;故障前后的请求是否成功要由业务记录确认,不能整批盲目补发。

观察新的持久化结果及剩余空间,确认错误没有立即复发。需要检查已有数据文件及恢复边界时,参考Redis重启后数据没了:RDB与AOF检查。本次恢复写入也不等于已经验证灾备,后续仍应按既定备份计划做隔离恢复验证。