ThinkPHP缓存标签失效的根本原因是驱动不支持或配置未启用：File驱动不实现标签接口，Redis需显式配置'use_tag'=>true且版本≥6.0.12，TP6.1+还需手动绑定TagCache类；标签清理依赖索引完整性，大小写敏感且不可含特殊字符。
ThinkPHP 缓存标签（tag()）在某些驱动下失效，根本原因不是写法错，而是驱动本身不支持或配置没打开——File 驱动压根不实现标签接口，Redis 驱动默认关闭 use_tag，APCu 和 Memcached 驱动则完全不兼容。
File 驱动调用 tag() 看似成功，实际无效
File 驱动没有元数据存储能力，无法维护“键 → 标签”映射关系。它不会报错，但所有 Cache::tag('user')->set() 都退化为普通缓存，后续 Cache::tag('user')->get() 或 clear('user') 都查不到任何东西。
- 运行
dump(Cache::tag('test')->getDriver() instanceof \think\cache\driver\File)可确认当前驱动类型 - 若返回
true，立刻停用tag()相关逻辑，改用手动 key 命名（如'user_info_123'）加Cache::delete()清理 - 不要指望
php think cache:clear能清掉带标签的项——File 驱动根本不记录标签索引
Redis 驱动未启用 use_tag 导致静默降级
TP6 的 Redis 驱动默认不开启标签支持，即使你写了 Cache::tag('user')->set()，底层也会跳过 tag 写入逻辑，只存原始缓存值，不写 tp:tag:user 索引。
- 检查
config/cache.php中stores.redis配置是否含'use_tag' => true（必须显式写出，不能靠默认） - Redis 扩展版本必须 ≥ 6.0.12，旧版
use_tag开启后仍会写入失败 - 验证方式：执行
Cache::tag('debug')->set('test', 'ok');后，用redis-cli连上执行SMEMBERS tp:tag:debug，应返回非空集合
TP6.1+ 报 Call to undefined method tag()
6.1 版本起，tag() 功能被解耦出核心，Cache 门面不再自动绑定 TagCache 类。旧项目升级后，Cache::tag() 直接不存在。
立即学习“PHP免费学习笔记（深入）”；
- 确认已安装
topthink/think-cache≥ v6.1.0 - 在
app/bootstrap.php或服务提供者中添加：Container::getInstance()->bind('cache', \think\cache\TagCache::class); - 验证绑定是否生效：
dump(Cache::getDriver() instanceof \think\cache\TagCache)必须返回true - 别改
config/cache.php中的'type' => 'tag'—— 没这个驱动类型，框架会直接报错或回退到 file
标签清理残留、clear('tag_name') 不彻底
Cache::clear('user') 并非原子删除，它先查 tp:tag:user 列表，再逐个删 key。如果并发写入或 key 已过期，列表和实际存在 key 就对不上。
- 执行
SMEMBERS tp:tag:user，若为空，说明之前set()根本没写进索引（配置或驱动问题） - 若非空但
GET某个 key 返回 nil，说明该 key 已被 Redis 自动淘汰，但索引没同步清理 - 线上避免依赖
clear('tag')做强一致性保障，关键业务建议用Cache::delete($key)显式删单条
最易忽略的是：标签名大小写敏感、不能含冒号或空格；Cache::tag('User')->clear() 和 Cache::tag('user')->clear() 是两个世界。写入时用什么标签，清除时就得一模一样拼写。
