Yii2没有原生cacheTag机制，所谓“标签”实为TagDependency手动模拟：它通过唯一字符串标记键绑定缓存项，需复用同一实例并调用invalidate()批量失效，不支持数组标签。
Yii2 的 cacheTag 是什么，为什么不能直接用数组当标签
Yii2 本身没有内置的「缓存标签」（cache tag）机制，cacheTag 不是框架原生支持的配置项或方法名。你看到的所谓“标签”功能，其实是靠 TagDependency 手动模拟出来的——它本质是把一组缓存项和一个「标记键」绑定，通过删标记键来批量失效关联缓存。
常见错误是这样写：['tag1', 'tag2'] 直接塞进 dependency，结果缓存不生效、清除失败、甚至报 Invalid Configuration。因为 TagDependency 的 tags 参数只接受字符串或单个字符串，不是数组。
- 必须用
TagDependency::invalidate()主动触发标记失效，而不是靠缓存自动识别 - 标记键（如
'user_profile_v2'）要全局唯一且可预测，否则清除时找不到目标 - 所有要用到该标签的缓存项，都得显式传入同一个
TagDependency实例，不能每次 new 一个
怎么正确创建并复用一个 TagDependency 实例
关键在于「实例复用」+「统一命名」。每次 new TagDependency 都会生成新标记键，导致清除时对不上。
推荐做法：在 common/components/CacheHelper.php 或配置文件里预定义好常用依赖实例：
// 示例：复用的依赖实例
$profileTag = new \yii\caching\TagDependency([
'tags' => 'user_profile'
]);
// 使用时：
Yii::$app->cache->set('user_123_profile', $data, 3600, $profileTag);
Yii::$app->cache->set('user_123_settings', $settings, 3600, $profileTag);
- 不要在每次
set()时 newTagDependency，否则每个缓存项绑定的是不同标记键 -
tags值建议用字符串，避免用数字或带空格/特殊字符的值，防止序列化后 key 异常 - 如果项目有多个环境，确保缓存前缀一致，否则
TagDependency::invalidate()在 dev 环境删不掉 prod 的缓存
批量清除缓存：调用 TagDependency::invalidate() 的时机和陷阱
清除不是删缓存本身，而是把标记键设为过期，让下次 get 时因依赖失效而跳过缓存。所以必须调用 TagDependency::invalidate()，且参数要和当初构造时完全一致。
典型错误：传错 cache 组件、没指定 cache、或者用了不同组件实例：
// ✅ 正确：指定同一 cache 组件，并传入原始 tags 字符串
\yii\caching\TagDependency::invalidate(Yii::$app->cache, 'user_profile');
// ❌ 错误：没传 cache，或传了别的组件（如 db 缓存）
\yii\caching\TagDependency::invalidate('user_profile'); // 报错
\yii\caching\TagDependency::invalidate(Yii::$app->redis, 'user_profile'); // 无效
- 必须确保
invalidate()调用的cache和当初 set 时用的是同一个组件（比如都是cache，不是cacheDb） - 如果缓存组件启用了
keyPrefix，invalidate()会自动加上前缀，无需手动拼接 - 清除操作本身不耗时，但后续首次访问会触发重建，注意并发场景下可能多次重建（需配合
mutex）
替代方案：不用 TagDependency，怎么更可靠地批量管理缓存
TagDependency 在高并发或分布式环境下容易出问题——比如 Redis 集群中 invalidate() 只作用于当前节点，或 APCu 不支持跨进程标记。
更稳的做法是「约定 key 命名规则 + 批量 del」：
// 约定前缀：user:123:profile、user:123:settings
Yii::$app->cache->set('user:123:profile', $data);
Yii::$app->cache->set('user:123:settings', $settings);
// 清除时（Redis 场景）：
Yii::$app->redis->delete(\yii\helpers\ArrayHelper::getColumn(
Yii::$app->redis->keys('user:123:*'), 0
));
- 适用于 Redis / Memcached；APCu 不支持通配符，慎用
- key 命名必须规范，避免
*误杀（例如user:1234:profile会被user:123:*匹配到） - 比
TagDependency更直观可控，但失去「自动失效」能力，需业务层主动清理
TagDependency 看似优雅，实际依赖缓存驱动的内部实现细节；真要批量清，不如把 key 设计清楚，再用存储层原生命令处理——尤其当缓存量大、节点多、或用的是非标准驱动时。
