phpredis认证必须显式配置password字段，不可用URL或环境变量自动注入；需确认扩展启用、Docker镜像已安装、配置中password键存在且值为null字面量，否则连接静默失败或报NOAUTH。

phpredis 认证必须通过 password 字段传入，不能靠 URL scheme 或环境变量自动注入；否则连接会静默失败或报 NOAUTH Authentication required。

确认 phpredis 扩展已启用且支持 AUTH

phpredis 从 4.0+ 开始完整支持 Redis AUTH 命令，但需确保： - php -m | grep redis 能看到 redis（不是 Redis 或空） - php --ri redis 输出中包含 Directive => Local Value 行，且无 fatal error - 若使用 Docker，PHP 镜像需显式安装 php-redis（如 php:8.2-cli 不自带）

在 config/database.php 中正确配置 password 参数

phpredis 不识别 auth、redis://:pass@host/ 等 Predis 风格写法，只认数组键 password。错误配置会导致连接建立后立即被 Redis 拒绝：

• ✅ 正确写法（必须显式声明 password）：

  'default' => [
      'host' => env('REDIS_HOST', '127.0.0.1'),
      'password' => env('REDIS_PASSWORD', null), // ← 这行不能省，null 也得写
      'port' => env('REDIS_PORT', 6379),
      'database' => env('REDIS_DB', 0),
  ],

• ❌ 错误写法：'scheme' => 'redis'、'url' => 'redis://:xxx@127.0.0.1'、漏掉 password 键、或写成 'auth' => ...
• ⚠️ 特别注意：env('REDIS_PASSWORD', null) 中的 null 必须字面量写出，不能是字符串 "null" 或空字符串 ""，否则 phpredis 会尝试用空密码 AUTH，触发拒绝

验证认证是否生效的最快方式

不要依赖 Cache::get()，它经过多层抽象，失败时可能 fallback 到 file 驱动而不报错。直接测底层连接：

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

• 在 Tinker 中运行：

  $client = new \Redis();
  $client->connect(env('REDIS_HOST'), (int)env('REDIS_PORT'));
  $client->auth(env('REDIS_PASSWORD')); // 显式调用，看是否抛出异常
  $client->set('test_auth', 'ok');

• 若报 RedisException: NOAUTH Authentication required，说明 password 没传进去或值为空字符串；若报 Connection refused，则是网络或端口问题
• 检查 .env 中 REDIS_PASSWORD 是否含空格或特殊字符（如 $、#），需用双引号包裹：REDIS_PASSWORD="my$ec#ret"

最容易被忽略的是：phpredis 的 auth() 调用发生在 connect() 之后、select() 之前，而 Laravel 的连接初始化顺序依赖配置项位置——password 必须和 host/port 同级出现在连接数组里，放错层级（比如塞进 options）就等于没配。

立即学习“PHP免费学习笔记（深入）”；