当前位置：首页 > news >正文

【BUG】Redis RDB快照持久化及写操作禁止问题排查与解决

news 来源：原创 2025/8/26 16:53:23

1 问题描述

在使用Redis 的过程中，遇到如下报错，错误信息是 “MISCONF Redis is configured to save RDB snapshots, but it is currently not able to persist on disk...”，记录下问题排查过程。

2 问题排查与解决

该错误提示表明，Redis 已配置 RDB 快照持久化功能，但当前无法将数据成功保存到磁盘。由于 stop-writes-on-bgsave-error 选项处于启用状态，所以写操作被禁止。以下为逐步排查与解决方法：

2.1 磁盘空间检查

在命令行执行 df -h 命令，仔细查看磁盘的使用情况。若磁盘空间不足，需及时清理无用文件，以释放足够的磁盘空间。例如，可删除系统中长时间未使用的安装包、临时文件等。
在这里插入图片描述

2.2 Redis 日志查看

首先要确定 Redis 日志文件的位置。默认情况下，日志文件可能位于 /var/log/redis/redis-server.log 路径下，不过也可通过 redis.conf 配置文件中的 logfile 配置项来准确确认。打开日志文件后，仔细查看其中关于 RDB 快照失败的详细信息，从中分析失败原因，常见原因包括权限不足或磁盘故障等。
在这里插入图片描述

2.3 Redis 配置检查

RDB 存储目录检查：确认 redis.conf 配置文件中 dir 所指定的 RDB 存储目录真实存在，并且 Redis 服务对该目录拥有写入权限。例如，若指定的目录为 /var/lib/redis，可通过以下命令进行检查与权限修正：
```
ls -ld /var/lib/redis  # 此命令用于检查目录权限
chown -R redis:redis /var/lib/redis  # 若权限不足，使用该命令修正目录所有者为redis用户
```

save 配置项检查：检查 save 配置项是否符合实际业务需求。save 配置项用于设定在特定条件下触发 RDB 快照的规则。例如：

save 900 1  # 表示在900秒内，若至少有1个键值对发生变化，则触发RDB快照，可根据实际需求灵活调整
save 300 10
save 60 10000

在这里插入图片描述

2.4 临时关闭写保护（仅适用于测试环境，生产环境慎用）

若想临时允许写操作，可通过 Redis 客户端执行以下命令：
redis-cli config set stop-writes-on-bgsave-error no

需注意，这只是临时解决方案。在生产环境中，应优先解决 RDB 持久化问题，因为直接关闭写保护可能会导致数据丢失风险。
在这里插入图片描述

2.5 Redis 服务重启（若修改了配置）

若在上述过程中对 Redis 配置进行了修改，需重启 Redis 服务，使新配置生效。在命令行执行：
sudo systemctl restart redis-server

按照上述步骤逐步排查，先解决磁盘空间、权限等底层问题，之后再验证 Redis 的写操作是否已恢复正常。