Apollo Client writeQuery变量可省略？与官方文档不符的疑问

核心原因：规范化缓存的工作机制 #

Apollo Client 默认采用规范化缓存，所有实体对象（比如你的Track、Author）都会以__typename:id作为唯一键存储。调用writeQuery时，它会完成两项操作：

1. 若提供query和variables，会更新该查询对应的缓存条目（基于query+variables的组合键）；
2. 自动遍历data中的所有实体，更新规范化缓存里的对应条目——这一步只依赖实体的__typename和唯一标识字段（默认是id，可通过dataIdFromObject自定义），和variables完全无关。

你的两个示例都是更新Track(id: c_1)实体本身，所以不管有没有variables，只要data里的Track带有正确的__typename和id，Apollo Client就会找到并更新规范化缓存中的对应条目，所有引用该实体的查询都会同步看到更新结果。

什么时候必须使用variables？ #

只有当你需要更新某个特定查询的缓存结果时，才必须提供variables。比如：

• 你有带参数的列表查询getTracks(limit: 10)，想要直接更新这个查询返回的数据集；
• 需要确保某个特定页面的查询结果被覆盖，而非仅更新实体本身。

这种场景下，variables用来定位“哪个查询的缓存结果需要更新”，如果缺少variables，Apollo Client无法匹配到对应的查询缓存条目，也就无法更新该查询的返回结果，但实体本身的规范化缓存依然会被更新。

和官方文档描述的差异 #

文档中提到的“通过variables中的id选择对应缓存项”，特指更新特定查询的缓存结果的场景，而非更新实体本身。文档未明确区分“更新查询缓存条目”和“更新规范化实体”这两个不同操作，容易造成误解。

适用场景总结 #

• 仅更新实体对象：无需variables，只要data中的实体包含__typename和唯一标识（id）即可，适用于所有修改实体数据的场景；
• 更新特定查询的缓存结果：必须提供匹配的variables，否则无法定位到目标查询缓存条目。

内容的提问来源于stack exchange，提问作者Velidan