Apollo/GraphQL执行Mutation后update缓存未更新ROOT_QUERY下的GET_CONTACTS

算力阿峰

2026-11-3

Apollo Mutation 缓存更新后父组件查询无响应的排查指南

核心触发原因（按出现概率从高到低排序）

writeQuery 写入的数据结构不匹配查询定义
你当前代码中 writeQuery 传入的根 data 是纯数组 [...getContacts, createContact]，但你的 GET_CONTACTS 查询的返回结构是 { getContacts: Contact[] }。Apollo 缓存要求写入的根数据必须和查询的返回字段完全对齐，这种省略根字段的写法会被判定为无效写入，根本不会更新对应查询的缓存条目，自然无法触发父组件的重新渲染。
修正后的核心写法：
```
cache.writeQuery({
  query: GET_CONTACTS,
  variables: { _id: user._id },
  // 必须完全匹配查询的根返回结构
  data: { getContacts: [...getContacts, createContact] },
});
```
你之前尝试的 cloneDeep、手动调用 client.writeQuery 的操作，如果本身 data 结构不对，不管怎么构造数据都不会生效，问题本质和数据是否深拷贝无关。
缓存操作使用的 Variables 和父组件实际查询不匹配
Apollo 缓存是通过「查询文档+序列化后的 Variables」生成唯一存储键的。如果你在 update 函数里读/写缓存时用的 variables，和父组件实际发起 GET_CONTACTS 时传的参数存在细微差异（比如父组件额外传了分页参数没在缓存操作里带上、_id 字段的类型为字符串但写操作时传了数字），你写入的根本不是父组件正在订阅的那个缓存条目，自然不会有联动更新。
新增联系人对象不满足实体缓存的标识要求
如果服务端返回的 createContact 对象没有带上对应类型的 __typename、也没有全局唯一的主键字段，Apollo 的实体归一化逻辑会直接把这个对象识别为无效数据，无法正常合并到列表缓存中。
缓存实例不属于全局共享的同一个 Client
如果你在嵌套组件里手动初始化了局部 Apollo Client 实例、或是引入了独立的缓存对象，你写入的缓存和父组件读取的缓存不属于同一个实例，自然不会触发跨组件的更新联动。