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 里的一致，但连接仍失败，大概率是特殊字符惹的祸：

• # 在 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。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！