tp5.1 的 cache::clear('tag_name') 仅清除内存标签索引，不删除实际缓存键；tp6+ 中 cache::tag('user')->clear() 才真正批量物理删除对应缓存键，且需缓存驱动支持标签功能。
缓存标签在 TP5.1 和 TP6+ 中的清除行为不一致
TP5.1 的 Cache::clear('tag_name') 实际上是“伪标签清除”——它只清内存中维护的标签索引，但不会主动扫描并删除对应缓存键；而 TP6 开始重构了标签底层，Cache::tag('user')->clear() 或 Cache::clear('user') 才真正触发批量物理删除。如果你在 TP5.1 升级后发现标签清除没效果，大概率是旧写法失效了。
- TP5.1：用
Cache::clear('tag_name')清除标签，仅清索引，需配合Cache::rm()手动删键，或直接删runtime/cache/目录 - TP6+：推荐统一用
Cache::tag('user')->clear()，它会遍历所有带该标签的缓存键并逐个删除（前提是缓存驱动支持标签，如file、redis） - 注意：
Cache::clear()（无参数）在所有版本都只清默认通道的全部缓存，与标签无关
php think clear 不清理缓存标签数据
命令行工具 php think clear 默认只清 runtime/cache/、runtime/log/、runtime/temp/，但它**完全不感知缓存标签结构**。即使你用了 Cache::set('key', $val, 3600, ['user'])，执行该命令后，标签索引文件（如 runtime/cache/tag/ 下的 PHP 文件）仍可能残留，导致后续 Cache::tag('user')->clear() 找不到目标键。
- TP6.1+ 支持
php think clear:cache --tag=user（需确认是否启用标签驱动），但多数项目仍依赖手动干预 - 安全做法：先运行
php think clear，再补一句Cache::tag('user')->clear()或直接删runtime/cache/tag/目录 - Redis 驱动下，标签实际以集合（
set）形式存在，php think clear对 Redis 里任何数据都无影响
标签失效失败的三个典型原因
缓存标签看似好用，但一碰就失效，往往不是代码写错，而是配置或环境卡住了。
-
'fields_cache' => false关闭字段缓存，但忘了关'tag' => true—— TP5.1+ 的标签功能默认关闭，必须在config/cache.php显式开启：'tag' => true - 使用
file驱动时，runtime/cache/tag/目录权限不对，Web 进程可读不可写，导致标签索引写入失败，后续清除自然找不到记录 - 多通道缓存场景下（比如同时配了
file和redis），Cache::tag('user')->set()写到了redis，但Cache::clear('user')调用的是默认file通道，两边根本不在一个地方
TP5.1.32 后标签性能限制带来的隐性问题
TP5.1.32 版本起，为防内存溢出，框架强制限制每个标签最多记录 1000 个缓存键。一旦超过，新加入的键会被丢弃，但旧键不会自动老化——结果就是你调 Cache::tag('list')->clear()，只清掉了前 1000 个，后面漏掉的还在跑。
- 现象：部分列表页刷新后数据没更新，但查日志又没报错
- 验证方式：临时加一行
dump(Cache::tag('list')->getKeys());，看返回数组长度是否卡在 1000 - 解决思路：避免单标签承载过多键，改用复合标签（如
['list', '202603']）或按业务域拆分标签名
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
