laravel连不上redis但redis-cli能通，说明服务正常，问题在laravel连接上下文：.env配置未生效（需php artisan config:clear并重启php-fpm）、redis_password=null与空字符串语义不同、docker挂载或php扩展（predis/phpredis）不匹配、多连接池（缓存/队列/session）独立配置导致部分不通。
redis-cli ping 能通但 Laravel 连不上
说明 Redis 服务本身是活的，问题出在 Laravel 的连接上下文里。最常见的是 .env 配置和实际运行环境不一致——比如你改了 .env，但没清缓存，Laravel 仍读取旧配置。
执行以下命令强制重载配置：
php artisan config:clear
再检查是否生效：
php artisan tinker --execute="dd(config('database.redis.default'))"
重点关注输出里的 host、port、password 是否和 .env 一致。特别注意：REDIS_PASSWORD=null 和 REDIS_PASSWORD=（空字符串）语义不同，前者会被当成 PHP null，后者是空密码，Laravel 会尝试用空密码鉴权。
容易踩的坑：
-
php-fpm进程可能缓存了旧的.env，重启它比只清 config 更可靠：sudo systemctl restart php-fpm - 如果用了 Docker，确认
.env文件确实挂载进了容器，且路径正确；宿主机改了.env，容器内未必同步 - Laravel 10+ 默认使用
predis，但如果你手动装了phpredis扩展并设了REDIS_CLIENT=phpredis，却没装扩展，就会静默 fallback 到失败
Connection refused 错误但 redis-cli 本地也连不上
先别急着查 Laravel，这是典型的 Redis 服务层问题。重点看三件事：
第一，服务进程是否真在跑：
systemctl status redis
如果显示 inactive (dead) 或 failed，直接启动：
sudo systemctl start redis
第二，配置文件是否被改过但没重载：
检查 /etc/redis/redis.conf 中这两项：
-
bind：若只写了127.0.0.1，而 Laravel 应用不在同一台机器（比如 Nginx + PHP-FPM 分离部署），就得加内网 IP 或改成0.0.0.0（仅限可信内网） -
protected-mode：若为yes且未设requirepass，远程连接会被拒，错误就是Connection refused，不是认证失败
改完必须重启服务：sudo systemctl restart redis，不能只 reload。
NOAUTH Authentication required 报错
这个错误意味着连接成功了，但鉴权失败。不是连不上，是“连上了却不让进”。关键点在于密码是否匹配、是否被忽略。
检查顺序：
- 确认
REDIS_PASSWORD在.env中有值，且和redis.conf里的requirepass完全一致（区分大小写、空格） - 如果
.env写的是REDIS_PASSWORD=yourpass，但redis.conf里是requirepass "yourpass"（带引号），Redis 实际认的是带引号的字符串，会导致不匹配 - 某些云 Redis 服务（如阿里云、腾讯云）的密码是控制台生成的，可能含特殊字符（如
@、/），需在.env中 URL 编码，否则 Laravel 解析时会截断 - 用
redis-cli -h <code>HOST-pPORT-aPASSWORDping 手动验证，能回PONG才算真正通
PHP 扩展或客户端不匹配
Laravel 的 Redis 客户端抽象背后依赖具体扩展。不匹配时不会报明确错误，而是连接行为异常（比如超时、静默失败）。
验证步骤：
- 运行
php -m | grep redis，确认输出包含redis（phpredis）或igbinary（predis 依赖） - 检查
config/database.php中'client' => env('REDIS_CLIENT', 'predis')，如果设成phpredis却没装扩展，会抛Class 'Redis' not found；如果设成predis却没装predis/predis包，也会失败 - Laravel 9+ 默认用
predis，但部分生产环境偏好phpredis（性能略高），此时必须确保extension=redis.so已启用，且php.ini中没有注释掉它
复杂点在于：Laravel 队列、缓存、Session 可能分别走不同 Redis 连接池，某一个通不代表全部通；php-fpm 和 CLI（artisan）用的可能是不同 PHP 配置，php -m 查到的扩展，CLI 下有，Web 请求下未必有。
