document.writeln('');
Redis服務是否已啟動并可被Laravel訪問?需先驗證Redis進程運行及網絡連通性,再確認.env中CACHE_DRIVER=redis等配置正確、config/cache.php匹配,最后清理配置緩存并檢查實際驅動是否為redis。

很多“連接失敗”其實不是 Laravel 配置問題,而是 Redis 服務根本沒跑起來,或 Laravel 所在環境(比如 Docker 容器、Homestead、云服務器)連不到 127.0.0.1:6379。先確認基礎連通性:
1 2 |
|
Connection refused,說明 Redis 進程未運行或端口被占1 |
|
PONG 才算通127.0.0.1 訪問宿主機 Redis;應改用宿主機 IP(如 172.17.0.1)或 Docker 網絡別名(如 redis)Laravel 的 Redis 緩存依賴兩個地方:環境變量控制連接參數,config/cache.php 控制驅動與默認 store。常見錯誤是只改了 .env 卻忘了 CACHE_DRIVER=redis,或誤以為改了 REDIS_HOST 就自動生效。
.env 中必須包含以下幾項(按需調整值):1 2 3 4 5 |
|
config/cache.php 中的 default => redis 必須匹配 stores.redis 配置段;若使用哨兵或集群,需額外配置 options => [cluster => redis] 并改寫 redis store 的 client 為 predis 或 phpredis.env 后務必清緩存:1 |
|
這通常不是連接問題,而是 Laravel 默認給所有緩存 key 加了前綴(laravel_database_),且使用了序列化協議。直接用 redis-cli get xxx 查不到,是因為 key 名不一致,且值是 PHP 序列化后的二進制數據。
tinker 中執行 1 |
|
redis-cli keys "*my_key*" 搜索帶前綴的 keyconfig/database.php 的 redis.default.prefix 設為空字符串(),但生產環境不建議phpredis 擴展,注意它默認不支持 unserialize,需在 redis store 配置中顯式設置 options => [serializer => php]光看 Cache::put() 不報錯不代表寫入成功;要確認讀寫路徑走的是 Redis,而不是 fallback 到 file 或 array 驅動。
config/cache.php 的 redis store 中加入 connection => default,然后在 tinker 中運行:1 2 |
|
redis-cli monitor 觀察是否有 SET 和 GET 命令發出1 |
|
redis,而非 file 或 arrayphpinfo() 中是否啟用了 redis 或 phpredis 擴展;僅安裝 predis/predis Composer 包不夠,某些操作(如 pipeline、Lua 腳本)仍需原生擴展支持