Redis 与缓存 / 知识点

Redis 故障排查手册

手册条目

确认 RDB、AOF 的启用状态、最近执行结果和数据安全风险。

检查 Redis 持久化状态

用于确认当前实例是否启用 RDB、AOF,最近一次落盘是否成功,以及故障或重启时可能丢失哪些数据。先读取运行状态,再核对生效配置;以下检查均为只读,不会主动触发快照或 AOF 重写。

快速检查

命令默认连接本机 127.0.0.1:6379。远程实例补充 -h <HOST> -p <PORT>;启用 ACL 时补充 --user <USER>,密码优先通过 REDISCLI_AUTH 传入,避免出现在进程列表和终端历史中。

bash
export REDISCLI_AUTH='<PASSWORD>'  # 无密码实例可删除此行

redis-cli --raw INFO persistence   | grep -E '^(rdb_changes_since_last_save|rdb_bgsave_in_progress|rdb_last_save_time|rdb_last_bgsave_status|aof_enabled|aof_rewrite_in_progress|aof_last_bgrewrite_status|aof_last_write_status):'

redis-cli --raw CONFIG GET save
redis-cli --raw CONFIG GET appendonly
redis-cli --raw CONFIG GET appendfsync
redis-cli --raw CONFIG GET dir
redis-cli --raw CONFIG GET dbfilename
redis-cli --raw CONFIG GET appenddirname
redis-cli --raw LASTSAVE

预期输出示例:

text
rdb_changes_since_last_save:42
rdb_bgsave_in_progress:0
rdb_last_save_time:<TIME>
rdb_last_bgsave_status:ok
aof_enabled:1
aof_rewrite_in_progress:0
aof_last_bgrewrite_status:ok
aof_last_write_status:ok
save
3600 1 300 100 60 10000
appendonly
yes
appendfsync
everysec
dir
/var/lib/redis
dbfilename
dump.rdb
appenddirname
appendonlydir
<TIME>

<TIME> 是 Unix 时间戳,实际值不同。appenddirname 在旧版本中可能不返回内容;这不等于 AOF 异常,应结合 Redis 版本和 aof_enabled 判断。

关键字段怎么读

字段或配置 正常判断 异常含义
rdb_last_bgsave_status ok err 表示最近一次后台快照失败
rdb_bgsave_in_progress 通常为 0 1 表示正在保存,先等待完成再定性
rdb_changes_since_last_save 越小表示 RDB 越新 持续增大表示最新变更尚未进入 RDB
aof_enabled 1 表示已启用 0 表示未使用 AOF
aof_last_write_status ok err 表示最近 AOF 写入出现错误
aof_last_bgrewrite_status ok err 表示最近 AOF 重写失败
save 非空表示存在 RDB 自动保存规则 空字符串表示未配置自动 RDB 快照
appendfsync always、everysec 或 no 决定 AOF 的同步频率与数据丢失窗口

LASTSAVE 只表示最近一次成功生成 RDB 的时间,不代表 AOF 已同步。判断 AOF 必须同时查看 aof_enabled、aof_last_write_status 和重写状态。

数据安全边界

仅启用 RDB 时,故障后可能丢失最近一次成功快照之后的变更;rdb_changes_since_last_save 可帮助判断当前缺口。仅启用 AOF 时,数据安全取决于 appendfsync:always 更稳但写延迟更高,everysec 通常把突然宕机的数据窗口控制在约一秒,no 由操作系统决定刷盘时机。

RDB 与 AOF 都关闭时,进程退出、主机重启或内存丢失后无法从本地磁盘恢复数据。两者同时启用时,重启通常优先使用更完整的 AOF 恢复;复制、Sentinel 或 Cluster 提供可用性,不等同于可回滚的离机备份。

风险与权限

INFO persistence 和 CONFIG GET 不修改数据,但常被 ACL 归为管理或危险命令,受限账号可能返回 NOPERM。不要为了“验证”直接执行 CONFIG SET、BGSAVE 或 BGREWRITEAOF;它们会改变运行状态或增加磁盘、内存压力。

运行时通过 CONFIG SET 修改的值不一定写回配置文件,重启后可能恢复旧值。确需变更时,应同步修改实际加载的配置文件,或在确认权限、配置路径和回滚方案后使用 CONFIG REWRITE。

排障结论

出现 rdb_last_bgsave_status:err、aof_last_write_status:err,或 RDB/AOF 同时关闭时,应按数据安全事件处理:先限制重启和故障切换操作,保留现有持久化文件,再定位磁盘、权限、内存及配置问题。

目录与阅读设置

记录一个想法

Redis 故障排查手册

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

登录哪都通