Apollo Client 虽无直接等价于 React Query invalidateQueries 的 API，但可通过 refetchQueries 选项在执行突变后精准触发指定查询的自动重获取，从而确保 UI 展示最新服务端数据。
apollo client 虽无直接等价于 react query `invalidatequeries` 的 api，但可通过 `refetchqueries` 选项在执行突变后精准触发指定查询的自动重获取，从而确保 ui 展示最新服务端数据。
在 Apollo Client 中，没有内置的全局“标记查询为过期”机制（如 React Query 的 invalidateQueries），但这并不意味着无法实现类似效果。核心思路是：在数据变更（如创建、更新）发生后，主动触发相关查询的重新执行，而非手动修补缓存——这恰好契合你“不操作缓存、只从服务端拉取新数据”的需求。
✅ 推荐方案：使用 refetchQueries 进行声明式重获取
refetchQueries 是 Apollo Client Mutation Hook（如 useMutation）提供的标准配置项，支持在突变成功后自动重执行一个或多个查询。它接受以下形式之一：
- 查询的 DocumentNode（推荐，类型安全且可被 Apollo 工具链识别）
- 查询名称字符串（需确保与 query 指令中 name 字段一致）
- 或更灵活的对象数组（含 query 和 variables）
import { gql, useMutation } from '@apollo/client';
const ADD_TODO = gql`
mutation AddTodo($input: TodoInput!) {
addTodo(input: $input) {
id
text
completed
}
}
`;
const GET_TODOS = gql`
query GetTodos($limit: Int) {
todos(limit: $limit) {
id
text
completed
}
}
`;
function TodoForm() {
const [addTodo, { loading }] = useMutation(ADD_TODO, {
// ✅ 方案1：传入 DocumentNode（强烈推荐）
refetchQueries: [GET_TODOS],
// ✅ 方案2：传入查询名称（需确保命名一致）
// refetchQueries: ['GetTodos'],
// ✅ 方案3：带变量的精确控制（适用于分页/过滤场景）
// refetchQueries: [{
// query: GET_TODOS,
// variables: { limit: 10 }
// }],
// ⚠️ 注意：refetchQueries 默认仅在 mutation 成功时触发（即 data 存在且无 error）
});
const handleSubmit = (input: { text: string }) => {
addTodo({ variables: { input } });
};
return (
);
}? 补充说明与最佳实践
- refetchQueries 是声明式、副作用可控的：它不会影响其他未声明的查询，避免意外重请求，比全局缓存清理更安全、更可预测。
- 不依赖缓存状态：即使缓存中存在旧数据，refetchQueries 会强制发起新的网络请求，返回结果后自动更新缓存和 UI，完全满足“以服务端为准”的诉求。
- 支持组合与条件判断：可通过 await 配合 client.refetchQueries() 手动调用（例如在自定义逻辑后），或结合 onCompleted 回调做更精细控制。
- 避免滥用 cache.evict / cache.reset：虽然可清除缓存项触发重获取，但易引发竞态、丢失局部状态，且无法保证按需刷新——refetchQueries 是更语义清晰、维护性更强的选择。
✅ 总结
Apollo Client 的 refetchQueries 就是你需要的 invalidateQueries 等效方案：它不修改缓存内容，而是通过显式声明依赖关系，在业务动作（如新增/编辑实体）完成后，自动、精准、可测试地重拉最新服务端数据。合理使用该机制，即可构建响应及时、数据可信、逻辑清晰的数据同步流程。
