tp6缓存标签失效主因是驱动不支持、配置错误或标签名不规范：file驱动不支持标签，redis需正确配置tag_layout和prefix；标签名须全小写且仅含字母、数字、下划线；清除必须同store调用clear()，云redis禁用keys时需改用eval脚本。
TP6缓存标签失效，不是标签“丢了”，而是标签写入、清除或驱动配置没对齐——最常见的是Redis前缀冲突、标签名不规范、clear()调用方式错误，或缓存驱动未真正支持标签功能。
确认标签是否真的被写入
ThinkPHP 的 Cache::tag() 本质是给 key 打标记，底层靠驱动实现。File 驱动不支持标签，Redis 驱动才真正可用。
- 检查 config/cache.php 中当前 store（如 'redis'）的 'tag_layout' 配置是否启用，默认为 '{tag}:key'，别删掉 {tag} 占位符
- 执行写入后，用 redis-cli 查看真实 key：
redis-cli -h 127.0.0.1 keys "think_tag:*"，应能看到类似think_tag:report的集合 key - 若查不到，说明标签根本没落库——可能用了 file 驱动，或配置中 store 名写错（比如写了 'redis_cache' 但配置里只有 'redis'）
标签名必须全小写且无特殊字符
TP6 对标签名校验严格：只接受纯小写字母、数字和下划线，其他一律静默失败，不报错也不写入。
- ✅ 正确：
Cache::tag('user')->set('profile_123', $data, 3600) - ❌ 错误：
Cache::tag('User')（大写）、Cache::tag('user:today')（含冒号）、Cache::tag('report_v2.1')（含点号） - 调试时可在写入后加一行：
dump(Cache::getTagItem('user'));，返回 null 就说明标签名非法或未生效
清除标签必须用对应 store + 显式调用
Cache::tag('xxx')->clear() 不等于清空所有缓存，它只清该标签下所有 key，且依赖驱动的原子性支持。
- Redis 场景下，确保配置中
'prefix' => 'myapp:'已设置（不能为空），否则多个项目会互相覆盖标签元数据 - 不要混用 store：用
Cache::store('redis')->tag('user')->set(...)写入，就必须用同 store 清除，Cache::tag('user')->clear()默认走 default store，易出错 - 若 Redis 禁用了 KEYS 命令（云 Redis 常见），
clear()会静默失败；改用前缀批量删：Cache::store('redis')->handler()->eval("redis.call('del', unpack(redis.call('smembers', 'think_tag:user'))); redis.call('del', 'think_tag:user');", 0)
避免多级缓存干扰标签行为
当同时开启路由缓存、模板缓存、配置缓存时，它们不走 Cache::tag() 机制，但会掩盖标签失效问题——你以为清了标签，其实页面还是旧的。
- 先执行
php think clear --all，再单独测试标签逻辑 - 临时关闭非必要缓存：在 config/template.php 中设
'cache_on' => false，config/route.php 中设'route_cache' => false - 验证是否真生效：写入后立即
Cache::tag('user')->get('profile_123')，再Cache::tag('user')->clear()，再次 get 应返回 null
