如何利用ThinkPHP模型字段只读虚拟字段实现缓存与多源合成字段持久化？

本文共计963个文字，预计阅读时间需要4分钟。

伪原创改写如下：

getXXXAttr 计算字段不会进模型缓存

getXXXAttr 方法在 toArray()、toJson() 或模板渲染时才执行，属于运行时动态计算，不落库也不进模型查询缓存。即使你对主模型调用了 cache(true)，比如 User::cache(true)->find(1)，缓存里存的仍是原始数据库字段，full_name 这类虚拟字段每次都会重新计算。

• 缓存命中后返回的是原始 $data 数组，getXXXAttr 不会自动触发
• 想让虚拟字段“看起来被缓存”，得手动把计算结果塞进缓存值里，比如用 Cache::set('user_1_full', $user->full_name, 3600)
• 别依赖 $model->getData() ——它跳过所有 getXXXAttr，只返回原始数据

组合缓存必须显式拼 key，不能靠 with() + cache(true)

with('profile') 预加载后调 cache(true)，缓存键是 think_model_User_find_1，跟是否加载 profile、是否用了 getTotalPriceAttr 完全无关。你要缓存“用户+资料+计算总价”这个组合结果，就得自己构造唯一 key。

• 推荐用数组方式生成缓存键：cache(['user_with_profile_total', $id], 3600)，ThinkPHP 会序列化为稳定字符串
• 如果总价依赖 profile 和 goods 两个关联，key 必须包含它们的更新时间戳或版本号，否则缓存无法感知关联变更
• 避免字符串拼接：cache('user_'.$id.'_'.time()) 这种写法让缓存失去复用价值

虚拟字段参与缓存时，关联数据必须已预加载且判空

getTotalPriceAttr 里若要取 $data['profile']['price']，前提是 profile 已通过 with('profile') 加载进来，且 $data['profile'] 不为 null。否则直接报错或返回 0，缓存里就存了个错误值。

立即学习“PHP免费学习笔记（深入）”；

• 必须在控制器或服务层统一做预加载：User::with(['profile', 'goods'])->find($id)
• 在 getXXXAttr 内部加判空：if (empty($data['profile'])) { return 0; }，别硬解包
• 字段名大小写必须和 with() 中定义的一致：with('UserProfile') 对应的 $data['UserProfile']，不是 $data['user_profile']

缓存失效难同步，别把虚拟字段当真实字段用

虚拟字段没有数据库实体，也就没有 UPDATE 触发器、事务回滚感知或软删除联动。一旦关联表数据变了，缓存里的组合结果就脏了，而且没法靠 Cache::tag('user')->clear() 自动清理——因为那个缓存 key 是你手写的，没打标签。

• 高频变更场景下，缓存有效期别设超过 60 秒，宁可多查几次，别返回错误总价
• 关键业务（如支付金额）建议放弃缓存虚拟字段，改用冗余字段：在订单表加 cached_total_price，由定时任务或事件监听器更新
• 如果非要用缓存，务必在关联更新时主动删 key：Cache::delete(['user_with_profile_total', $userId])

最常被忽略的一点：getXXXAttr 是模型实例方法，但缓存是静态存储。你在一个请求里修改了 $user->status，再调 $user->total_price，它可能用的是旧关联数据——因为缓存没刷新，而 getXXXAttr 又没重载逻辑去拉新数据。