yii2 redis缓存生效的核心是正确配置cache组件并规范使用set/get：必须用'yii\redis\cache'类、单独定义redis连接组件、设keyprefix防冲突、密码和database需显式配置，且过期时间单位为秒；未命中时应判断===false或直接用getorset()。
Yii 框架里用 Redis 做缓存，核心就两件事：正确配置 cache 组件，以及在业务中用对 set() 和 get()。其他花哨功能（比如依赖、集群、锁）都是锦上添花，没配好基础组件，全白搭。
怎么配 cache 组件才能让 Redis 真正生效
很多人配完发现缓存不走 Redis，查日志也没报错——大概率是漏了 redis 子组件声明，或者类名写错。
-
'class' => 'yii\redis\Cache'必须写全路径，不能简写成'yii\caching\RedisCache'（这根本不存在） - 必须同时定义一个独立的
redis组件，供cache复用连接；只在cache里嵌套'redis' => [...]是旧版写法，Yii 2.0.14+ 已不推荐 -
keyPrefix强烈建议设置，比如'keyPrefix' => 'prod_v2_'，避免开发/测试/生产环境缓存键冲突 - 如果 Redis 服务启用了密码，必须在
redis组件里加'password' => 'your_pass'，否则连接直接失败但不会抛异常，只会静默退化为 dummy cache
正确配置示例（放在 config/web.php 的 components 中）：
return [
'components' => [
'redis' => [
'class' => 'yii\redis\Connection',
'hostname' => '10.0.1.5',
'port' => 6379,
'database' => 2,
'password' => 'a1b2c3',
],
'cache' => [
'class' => 'yii\redis\Cache',
'keyPrefix' => 'prod_v2_',
'redis' => ['class' => 'yii\redis\Connection'], // 这里只是复用，不是重定义
],
],
];
Yii::$app->cache->set() 的过期时间单位是秒，别写错
这是线上最常踩的坑：传 3600 是 1 小时，传 3600 * 1000 就变成缓存 40 天，导致数据长期不更新；反过来，传 5 却以为是 5 分钟，实际只有 5 秒，缓存频繁击穿。
- 所有过期时间参数（第三个参数）单位统一是「秒」，和 PHP 的
time()对齐 - 不要硬编码数字，用常量或配置项管理，比如
self::CACHE_TTL_HOT_PRODUCT => 300 - 高并发场景下，避免大量缓存同时过期，可加随机偏移：
300 + rand(0, 60)
缓存未命中时，别在 get() 后直接 set() —— 注意 false 和 null 的区别
get() 返回 false 表示「缓存键不存在或已过期」，返回 null 可能是业务数据本身为 null。直接判断 === false 是唯一安全方式。
- 错误写法：
if (!$data) { ... }—— 如果缓存里存的是0、''、[]，也会进逻辑，造成重复查询 - 正确写法：
if ($data === false) { ... } - 更稳妥的做法：用
getOrSet()，它内部已处理好判断和回源逻辑，一行顶三行
示例：
$data = Yii::$app->cache->getOrSet('user_profile_' . $id, function () use ($id) {
return User::findOne($id);
}, 3600);
什么时候该用 flush()，什么时候不该
flush() 是清空整个缓存实例，不是删单个 key。线上误调用等于“缓存雪崩”。
- 部署新版本后需要清旧缓存结构？用
delete()或带前缀的批量删（如scan+del），别flush() - 紧急修复某个缓存污染问题？先
delete('key_name')，确认无误再推广 - 开发环境调试？可以放心
flush()，但确保YII_ENV不是prod - 注意：
flush()不会清 Redis 的其它 database，只清当前cache配置里指定的database
真正容易被忽略的是：缓存组件初始化失败时，Yii::$app->cache 会自动 fallback 到 yii\caching\DummyCache，所有 set()/get() 都静默失效——所以每次上线后，务必用 var_dump(Yii::$app->cache) 确认实例类型是不是你预期的 yii\redis\Cache。
