ThinkPHP缓存失效问题分三类：字段结构变更需清schema缓存；关联查询需显式清除带标签的缓存；save()不自动失效业务缓存，须业务层统一处理清除时机与范围。
模型字段条件缓存失效时，where 条件没变但查不到新数据
ThinkPHP 的模型查询默认会缓存字段结构（比如 getSchema 结果），但不会自动感知数据库表结构变更。如果加了新字段、改了字段类型或注释，而缓存没清，where 查询可能走错字段映射，导致条件失效或查不到数据。
- 典型表现：
where('status', 1)返回空，但手动查表确认有数据；debug发现$model->getSchema()里没有刚加的status字段 - 不是 ORM 缓存（如
cache(true)），而是字段元信息缓存，路径通常是runtime/schema/下的 PHP 文件 - 开发环境建议关掉字段缓存：
'schema_cache' => false放在数据库配置里，避免反复清缓存 - 上线后必须清一次：
php think clear:config或手动删runtime/schema/目录
关联数据更新后，with 查出来的旧数据没刷新
ThinkPHP 的 with 关联查询本身不带缓存，但如果你在关联定义里写了 cache(true)，或者上层用了 cache()，就可能命中过期关联数据。
- 常见错误：更新了
User关联的Profile表，但User::with('profile')->find(1)还是返回旧头像 URL -
with不会自动监听关联表变更，它只管“查的时候要不要缓存”，不管“缓存该不该失效” - 稳妥做法是显式清关联缓存：
Cache::tag('user_profile')->clear()，前提是你在关联方法里用tag('user_profile')标记过 - 如果没打标签，只能清整个缓存：
Cache::clear()，但代价大；更细粒度的做法是在更新Profile后，主动删掉对应用户的缓存键，比如Cache::delete('user_with_profile_1')
save() 成功但关联缓存没失效，前端看到“假更新”
ThinkPHP 模型的 save() 方法只负责当前模型数据写入，完全不处理关联表或缓存逻辑。所谓“关联缓存失效”，得你手动触发。
- 例如：
$user->save()更新了用户昵称，但首页轮播里还显示旧昵称，因为轮播数据是从缓存读的，且没被通知更新 - 别指望
afterSave钩子自动清缓存——它只对当前模型生效，不会知道你前端哪个接口用了哪条缓存 - 推荐在业务层统一收口：封装一个
updateUserWithCacheClear($id, $data)，里面先save，再删相关缓存键（如user_detail_{$id}、home_banner） - 注意事务边界：如果
save在事务里，缓存清除操作不能放事务外，否则可能清了缓存但事务回滚，造成短暂不一致
清缓存命令没效果？检查 cache 配置驱动和标签支持
php think clear:cache 只清应用级缓存，对文件驱动有效，但对 Redis 或 Memcached 驱动，如果没配 tag 支持，clear('tag_name') 就会静默失败。
立即学习“PHP免费学习笔记（深入）”；
- Redis 驱动默认不支持标签（
tag），除非你启用了redis_tag扩展或换用think-redis第三方包 - 检查配置：
cache.driver是redis还是file；如果是redis，确认cache.redis.tag_handler是否设为redis或memcache - 最简单的验证方式：
Cache::tag('test')->set('key', 'val');然后Cache::tag('test')->clear();，再var_dump(Cache::get('key'));—— 如果还存在，说明标签功能未生效 - 生产环境慎用
Cache::clear()，它会清空所有缓存，包括系统配置、路由规则等，可能导致瞬间大量 DB 查询
clear:cache 命令解决不了问题。 
