Yii2 Redis连接失败默认静默降级为DummyCache，根本原因是redis组件未正确定义或加载：未安装yii2-redis扩展、phpredis未启用、extensions.php中alias映射错误，或配置中遗漏独立redis组件（必须显式声明'components'=>['redis'=>[...]]），导致缓存无法真正使用Redis。
Yii2 Redis 连接失败默认不报错，只静默 fallback 到 DummyCache，所以你调用 $cache->get() 返回 false 却看不到任何提示——这不是“没命中”，而是“根本没连上”。
检查 Redis 组件是否被正确加载
错误 Failed to instantiate component or class "yii\redis\Connection" 说明 Yii 根本找不到这个类。常见原因有三个：
-
yiisoft/yii2-redis没通过 Composer 安装，或安装后没生成自动加载规则（composer dump-autoload没跑） -
phpredis扩展未启用：运行php -m | findstr "redis"（Windows）或php -m | grep redis（Linux/macOS），无输出就说明 PHP 层没加载扩展 - 手动复制了
yii2-redis到vendor但没更新vendor/yiisoft/extensions.php中的 alias 映射，导致@yii/redis路径解析失败
确认配置里 redis 是独立组件而非嵌套写法
Yii 2.0.14+ 已废弃在 cache 配置里直接写 'redis' => [...] 的方式。必须显式定义一个 redis 组件：
'components' => [
'redis' => [
'class' => 'yii\redis\Connection',
'hostname' => 'localhost',
'port' => 6379,
'database' => 0,
// password 必须显式写，空字符串也得是 'password' => ''
],
'cache' => [
'class' => 'yii\redis\Cache',
'redis' => ['class' => 'yii\redis\Connection'], // ← 这行只是引用，不能替代上面的 'redis' 组件
],
]
如果漏掉顶层 'redis' => [...]，yii\redis\Cache 初始化时会尝试 new 一个 yii\redis\Connection 实例，但因配置缺失而静默失败，最终降级为 DummyCache。
让连接失败立刻暴露而不是静默降级
Yii 默认对 Redis 连接异常做了容错处理，但开发阶段你需要它“炸出来”：
- 在入口文件
web/index.php开头加：error_reporting(E_ALL); ini_set('display_errors', '1'); - 临时在
config/web.php的cache配置里加'as log' => 'yii\log\Logger'并确保日志通道开启，Redis 连接失败会在runtime/logs/app.log里留下Failed to connect to Redis server记录 - 最直接的办法：在任意 action 里手动触发连接测试：
try { Yii::$app->redis->ping(); } catch (\Exception $e) { throw new \yii\web\HttpException(500, 'Redis connection failed: ' . $e->getMessage()); }
密码或 database 错误导致 AUTH 失败却不报错
错误信息 Redis error: NOAUTH Authentication required 或 Redis command was: AUTH xxx 表明 Yii 尝试发了 AUTH 命令但被拒绝。关键点：
- 检查
main-local.php是否覆盖了main.php的redis配置——尤其是password字段，若main.php有密码而main-local.php没写'password' => ''，Yii 会继承main.php的非空值，导致向无密码 Redis 发 AUTH - 云 Redis（如 AWS ElastiCache）通常禁用 AUTH，但如果你在配置里留了
'password' => 'xxx'或甚至'password' => null，Yii 仍会发送 AUTH 命令；必须显式写成'password' => '' -
database值超出服务端允许范围（比如 Redis 配置了databases 16，你却设database => 20）也会在 AUTH 后立即断连，但错误日志里只显示连接重置，需用redis-cli -h x.x.x.x -p 6379 ping手动验证
真正麻烦的不是连不上，而是连不上还假装连上了——缓存读写全走 dummy，线上查半天才发现 Redis 配置从没生效过。
