PHP连接Redis报“Authentication failed”90%因requirepass未生效或客户端未发AUTH命令：需确认redis.conf路径、语法正确性、重启服务；PHP必须显式调用auth()；密码含#、$等特殊字符需URL编码或单引号包裹。
PHP 连接 Redis 报 “Authentication failed”，90% 是 requirepass 没生效，或客户端根本没发 AUTH 命令。
redis.conf 里的 requirepass 没被加载
宝塔面板改完配置不等于 Redis 实际读到了——必须确认进程启动时加载的是哪个配置文件：
- 执行
ps aux | grep redis，找--config后面的路径（比如/www/server/redis/redis.conf）；没带--config就默认用/etc/redis/redis.conf - 打开对应文件，检查
requirepass行：不能有前置空格、不能在行尾加空格或#注释、不能写成requirepass = xxx（等号是错的） - 正确写法只有一行：
requirepass Xk9#qL2@mNv$RzW! - 改完必须重启服务：
systemctl restart redis或宝塔面板点「重启」；仅 reload 不生效
PHP 客户端压根没发 AUTH 请求
Redis 协议要求连接后主动认证，phpredis 扩展不会自动从 URL 或配置里读密码，也不会隐式 auth：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 面向过程写法必须显式调用：
$redis->connect('192.168.1.100', 6379); $redis->auth('Xk9#qL2@mNv$RzW!'); - Laravel 用户注意：
.env中要写REDIS_PASSWORD=Xk9#qL2@mNv$RzW!，且config/database.php的 redis 配置块里得有'password' => env('REDIS_PASSWORD', null) - 如果用
session.save_path = "tcp://192.168.1.100:6379?auth=Xk9#qL2@mNv$RzW!"，#和$会被当 URL 特殊字符解析，必须 URL 编码为%23和%24
密码本身被客户端误解析
PHP 代码里写的密码和 redis.conf 里的一致，但连接仍失败，大概率是特殊字符惹的祸：
立即学习“PHP免费学习笔记（深入）”；
-
#在 URL 中是 fragment 分隔符，$在 shell 变量展开中会被吃掉，@在连接串里是 host 分隔符 - 命令行测试用
redis-cli -h 192.168.1.100 -p 6379 -a 'Xk9#qL2@mNv$RzW!'（单引号包裹） - PHP 中若用双引号字符串写密码，
$会被 PHP 当变量前缀处理，必须用单引号或转义：'Xk9#qL2@mNv\$RzW!' - 最稳做法：换一个不含
# $ @ / ?的密码，比如R3disSec2026!
真正卡住人的地方，往往不是“怎么设密码”，而是“改了哪份配置、被哪个进程读、客户端怎么传、哪些字符要逃逸”这四层嵌套。漏一层，就卡在 NOAUTH Authentication required。
