Ubuntu Redis配置常見問題解答

Ubuntu Redis配置常見問題及解答

1. Redis啟動失敗

• 現象：使用systemctl start redis啟動時，日志報錯“Failed listening on port 6379 (tcp), aborting”或服務狀態顯示“exit-code”。
• 原因及解決：
  • 端口占用：6379端口已被其他程序占用。通過ss -ltnp | grep 6379或lsof -i :6379 -sTCP:LISTEN定位占用進程，用kill -9 <PID>終止進程；若需更換端口，修改/etc/redis/redis.conf中的port項（如port 6380），并重啟Redis。
  • 權限不足：非root用戶無法綁定1024以下端口（如6379）。兩種方案：① 賦予redis-server綁定低位端口權限（sudo setcap 'cap_net_bind_service=+ep' /usr/bin/redis-server）；② 改用高位端口（如6380），并更新systemd服務文件中的port配置（若有）。
  • 配置文件錯誤：配置文件存在語法錯誤或重復指令。使用grep -E "^(port|bind|dir|daemonize)" /etc/redis/redis.conf檢查關鍵配置項，刪除重復的port或bind行；通過redis-server /etc/redis/redis.conf --test-config測試配置文件語法。

2. 遠程訪問失敗

• 現象：從遠程客戶端連接Redis時，提示“Connection refused”或“Could not connect to Redis at :6379: Connection refused”。
• 原因及解決：
  • 綁定地址限制：默認bind 127.0.0.1僅允許本地訪問。修改/etc/redis/redis.conf中的bind項為0.0.0.0（允許所有IP訪問）或特定IP（如bind 192.168.1.100），并重啟Redis。
  • 保護模式未關閉：默認protected-mode yes禁止遠程訪問。修改protected-mode no，或在protected-mode yes時設置密碼（requirepass your_password）。
  • 防火墻攔截：Ubuntu的ufw防火墻未允許Redis端口。使用sudo ufw allow 6379/tcp開放端口，或替換為自定義端口（如6380）。

3. 內存占用過高

• 現象：Redis占用內存持續增長，甚至觸發系統OOM Killer終止進程。
• 原因及解決：
  • 未設置最大內存：默認無內存限制，易導致內存耗盡。在/etc/redis/redis.conf中設置maxmemory（如maxmemory 2gb），限制Redis使用的最大內存。
  • 內存淘汰策略不當：未設置淘汰策略時，Redis無法自動清理舊數據。設置maxmemory-policy（如allkeys-lru，淘汰最近最少使用的鍵；volatile-lru，僅淘汰設置了過期時間的鍵），根據業務需求選擇。

4. 數據丟失

• 現象：Redis重啟后數據未恢復，或系統崩潰后數據丟失。
• 原因及解決：
  • 持久化配置缺失：默認可能未開啟RDB或AOF持久化。修改/etc/redis/redis.conf：① RDB配置（快照）：save 900 1（900秒內至少1個鍵修改則保存）、save 300 10（300秒內至少10個鍵修改）、save 60 10000（60秒內至少10000個鍵修改）；dbfilename dump.rdb（RDB文件名）；dir /var/lib/redis（保存目錄）；② AOF配置（日志）：appendonly yes（開啟AOF）；appendfilename "appendonly.aof"（AOF文件名）；appendfsync everysec（每秒同步一次，平衡性能與數據安全）。
  • 未定期備份：即使開啟持久化，也需定期備份dump.rdb或appendonly.aof文件（如使用rsync或scp復制到遠程服務器）。

5. 權限問題

• 現象：啟動Redis時報錯“Permission denied”（如無法訪問數據目錄/var/lib/redis），或連接時報錯“NOAUTH Authentication required”（未認證）。
• 原因及解決：
  • 數據目錄權限不足：Redis進程對數據目錄無讀寫權限。修改數據目錄權限（如/var/lib/redis）：sudo chown -R redis:redis /var/lib/redis（所有者為redis用戶）、sudo chmod -R 755 /var/lib/redis（讀寫執行權限）。
  • 未設置密碼：默認無密碼，需設置密碼增強安全性。修改/etc/redis/redis.conf中的requirepass項（如requirepass your_password），重啟Redis后，客戶端連接時需使用auth your_password認證。
  • PID文件殘留：Redis異常終止時，/var/run/redis_6379.pid文件未刪除，導致下次啟動時報錯“Can’t open PID file”。手動刪除殘留文件：sudo rm -f /var/run/redis_*.pid，并重啟Redis。

6. 配置文件路徑問題

• 現象：修改配置文件后，重啟Redis未生效，或提示“Configuration file not found”。
• 原因及解決：
  • 配置文件路徑錯誤：默認配置文件路徑為/etc/redis/redis.conf，若修改了路徑，需確保systemd服務文件（/etc/systemd/system/redis.service）中的ExecStart項指向正確路徑（如ExecStart=/usr/bin/redis-server /etc/redis/redis.conf）。
  • 未重載systemd配置：修改服務文件后，需運行sudo systemctl daemon-reload使配置生效，再重啟Redis。