根本原因是Laravel配置与Redis服务端配置不匹配：.env中REDIS_HOST/PORT未同步实际监听地址和端口；redis.conf中bind或protected-mode限制非本地连接；REDIS_DB值为空字符串导致ERR invalid DB index；客户端类型（predis/phpredis）未在config/database.php中正确指定。
连不上 Redis 的根本原因，90% 出在 Laravel 配置与 Redis 服务端配置不匹配，而不是网络或代码逻辑问题。
检查 REDIS_HOST 和 REDIS_PORT 是否和实际服务一致
很多情况下，.env 里写的还是默认值 REDIS_HOST=127.0.0.1 和 REDIS_PORT=6379，但实际 Redis 要么改了端口（比如 6999），要么跑在 Docker 容器或远程服务器上，IP 根本不是本地回环地址。
- 先在 Redis 服务器上执行
redis-cli ping，确认能返回PONG - 再用
netstat -tuln | grep :<code>端口号查看 Redis 真实监听的地址和端口 - 如果 Redis 在 Docker 中，
REDIS_HOST应该填容器名（如redis）或宿主机 IP，不能写127.0.0.1（它会指向容器自身） - Laravel 启动后缓存了配置，改完
.env必须运行php artisan config:clear
REDIS_CLIENT 设置错误导致类找不到
Laravel 默认使用 predis 客户端，但如果你通过 PECL 安装了 phpredis 扩展，却没改配置，就会报 Class 'Predis\Client' not found 或连接静默失败。
- 检查是否已安装扩展：
php -m | grep redis—— 如果输出含redis（不是predis），说明是phpredis - 必须在
config/database.php中显式指定：'client' => 'phpredis' - 若同时装了两个扩展但没设
client，Laravel 可能随机 fallback，行为不稳定 - 注意命名冲突：PECL 的
Redis类和 Laravel 的RedisFacade 同名，Laravel 4.x+ 需确保app/config/app.php（旧版）或自动发现机制没引发别名覆盖
protected-mode 和 bind 配置让连接被服务端直接拒绝
即使 Laravel 配置全对、网络通、端口开，Redis 服务端也可能主动拒接——这是它自己的安全策略在起作用。
- 查
/etc/redis/redis.conf：如果bind是127.0.0.1，而你的 Laravel 在另一台机器，连接必然失败，错误常为Connection refused - 如果
protected-mode yes且未设requirepass，Redis 会拒绝所有非本地连接，哪怕bind 0.0.0.0也无效 - 临时验证方法：把
protected-mode no，重启 Redis（sudo systemctl restart redis），再试连接；成功后再补密码并收紧配置 - 生产环境不要长期关
protected-mode，正确做法是：绑定内网 IP + 设强密码 + 配合防火墙白名单
REDIS_DB 值为空字符串引发 ERR invalid DB index
这个错误很隐蔽：看起来 .env 写了 REDIS_DB=0，但 Laravel 解析时可能把它当成了空值，最终发出去的命令是 SELECT（缺参数），而不是 SELECT 0。
- 现象：
failed: ERR invalid DB index [tcp://localhost:6379] - 原因：环境变量值被 PHP 当作空字符串处理，
env('REDIS_DB', 0)返回的是空串而非整数0 - 解决：在
.env中明确写成REDIS_DB="0"（加引号），或直接删掉这行让 Laravel 用默认0 - 额外检查点：
config/database.php中database键是否被覆盖成字符串"0"而非整数0，某些中间件或配置合并逻辑会强制类型转换
最易被忽略的一点：Redis 连接失败时，Laravel 默认不抛出详细错误，而是静默 fallback 到文件缓存或直接报 500。务必打开 APP_DEBUG=true 并查看日志里的真实异常堆栈，否则你看到的永远只是表层症状。
