如何解决CentOS Redis启动失败问题

CentOS Redis 启动失败排查与修复

一、快速定位

• 查看服务状态与最新日志，优先抓取报错关键词
  • 执行：systemctl status redis -l 或 journalctl -xeu redis
  • 常见关键词：Address already in use（端口占用）、Permission denied（权限）、Fatal error loading the DB（持久化文件损坏）、Can’t open config file（配置路径错误）
• 前台直接校验配置是否能启动（能最快暴露语法/路径错误）
  • 执行：redis-server /etc/redis.conf
  • 若前台启动成功，多半是 systemd 单元或权限/路径问题；若失败，终端会直接打印错误原因

二、常见原因与对应修复

• 配置文件错误
  • 核对关键项：bind（如仅本地用 127.0.0.1，需要远程访问改为 0.0.0.0 并配合安全策略）、port（默认 6379）、daemonize yes、logfile（如 /var/log/redis/redis.log）、dir（如 /var/lib/redis）
  • 修复：修正后再次前台校验 redis-server /etc/redis.conf，再 systemctl restart redis
• 端口被占用
  • 检查：ss -lntp | grep 6379 或 netstat -tulpen | grep 6379
  • 处理：释放占用进程（kill <PID>）或修改 redis.conf 的 port
• 权限与目录所有权
  • 常见现象：日志或数据目录不可写
  • 修复：
    • chown -R redis:redis /var/lib/redis /var/log/redis
    • chmod 750 /var/lib/redis /var/log/redis
    • chmod 640 /var/log/redis/redis.log
• SELinux 拦截
  • 排查：getenforce（返回 Enforcing 表示开启）
  • 临时放行：setenforce 0（仅用于排查，确认后再配置策略或永久调整）
• 持久化文件损坏
  • 现象：日志含 “Fatal error loading the DB … Invalid argument”
  • 处理：备份后移除损坏的 RDB/AOF 文件（如 /var/lib/redis/dump.rdb 或 appendonly.aof），再启动；必要时从备份恢复
• 内存不足
  • 排查：free -m、dmesg | tail
  • 处理：释放内存、关闭不必要服务，或临时增加 swap 分区/文件
• 防火墙/网络策略（影响“连不上”，一般不致“起不来”）
  • 如需远程访问：firewall-cmd --add-port=6379/tcp --permanent && firewall-cmd --reload

三、最小可用配置示例

• 建议先用最小可用配置验证能启动，再逐步恢复安全与性能项
  • bind 127.0.0.1（仅本地）或 bind 0.0.0.0（需配合安全策略）
  • port 6379
  • daemonize yes
  • logfile "/var/log/redis/redis.log"
  • dir "/var/lib/redis"
  • appendonly no（先排除 AOF 导致的问题）
  • requirepass yourpassword（如需密码）
  • 前台验证：redis-server /etc/redis.conf；成功后 systemctl restart redis && systemctl status redis -l

四、验证与收尾

• 服务与连通性验证
  • 服务：systemctl is-active redis（应返回 active）
  • 本地连通：redis-cli ping（应返回 PONG）
  • 远程连通（如配置了远程）：redis-cli -h <IP> -p 6379 ping
• 设置开机自启
  • 执行：systemctl enable redis && systemctl restart redis