ThinkPHP虚拟字段缓存不生效是因为getAttr方法返回的值不进入$data，故不被序列化缓存；需通过setAttr手动注入$data、重写toArray确保包含，并按源字段哈希生成缓存key且联动清除。
模型里定义只读虚拟字段为什么缓存不生效
ThinkPHP 的 getAttr 或 getXXXAttr 方法定义的虚拟字段，默认不会被写入缓存（包括 cache(true) 或 Cache::remember 场景），因为框架只序列化模型的原始数据（$this->data），不包含动态计算的属性。即使你用 visible 暴露了该字段，缓存取出后依然为空或未触发 getter。
- 只读字段必须在缓存「写入前」就完成计算并注入到
$this->data，否则缓存里没有它 -
append方法（如$model->append(['status_text'])）仅影响当前实例，不改变缓存内容 - 若用
toArray()+cache(true)，需确保 append 已执行且结果已合并进数组，但下次从缓存反序列化时仍是原始数据
如何让虚拟字段参与缓存并保持联动更新
核心思路是：把虚拟字段“固化”进模型数据，同时拦截字段变更通知缓存失效。不能依赖运行时 getter，而要主动控制缓存键和写入时机。
- 在模型的
save()或update()后，手动调用$this->setAttr('virtual_field', $value)再保存，确保它进入$this->data - 缓存 key 必须包含所有影响该虚拟字段的源字段哈希，例如：
'user_'.$id.'_status_text_'.md5($this->status.$this->type) - 多源字段变更时（如
status和level共同决定badge），需在setAttr钩子中监听二者，触发Cache::delete()清除旧 key - 避免在
getBadgeAttr里查数据库或远程接口——这会导致缓存命中时仍发起额外请求
多源字段联动失效的典型错误写法
常见于想“自动响应字段变化”的场景，比如 score 和 rank_type 改变时，level_name 应刷新，但缓存没清、或计算逻辑被跳过。
- 直接在
getLevelNameAttr里写业务逻辑：缓存存在时整个方法不执行，字段永远不变 - 用
protected $append = ['level_name']但没配cache(true)或没重写toArray()注入值 - 在控制器里先
$user->cache(true)->find($id)，再$user->append(['level_name'])：append 不会回写进缓存，下次取还是旧数据 - 监听
after_write事件删缓存，但 key 拼写错误（如漏了_level_name后缀），导致旧缓存一直残留
一个可落地的组合方案示例
以用户等级文本为例，它由 score 和 rank_type 共同决定，并需强一致性缓存：
立即学习“PHP免费学习笔记（深入）”；
// 在模型中
protected $autoWriteTimestamp = true;
public function setLevelNameAttr()
{
// 手动计算并塞进 data，确保进缓存
$level = $this->score >= 1000 ? 'VIP' : ($this->score >= 100 ? 'Member' : 'Guest');
$this->data['level_name'] = $level . '_' . $this->rank_type;
}
// 重写 toArray，强制包含（防止 append 被忽略）
public function toArray()
{
$data = parent::toArray();
if (!isset($data['level_name'])) {
$this->setLevelNameAttr();
$data['level_name'] = $this->data['level_name'];
}
return $data;
}
// save 后清除所有相关缓存
protected function afterWrite($name)
{
$key = 'user_' . $this->id . '_level_name_*';
Cache::delete($key); // ThinkPHP 6.1+ 支持通配符，否则需精确 key
}
调用时用 UserModel::cache(true)->find($id) 即可拿到含 level_name 的缓存结果，且任意源字段变更都会清旧缓存。
最易忽略的是：缓存 key 的粒度必须和字段依赖关系对齐；哪怕只改了一个源字段，只要它参与了虚拟字段计算，就得清掉所有对应缓存——否则就不是联动，是残留。
