Apollo GraphQL查询子元素数组被其他查询覆盖问题咨询

这看起来是GraphQL客户端缓存常见的数据歧义问题，核心原因是两个查询返回的types字段被缓存系统当成了同一组数据，导致子集数据被完整集覆盖。先再明确下你的场景：

我有两个用于获取公司分类类型的GraphQL查询，员工查询返回的类型是数据库中公司查询类型的子集。单独查询员工查询时，其types数组包含2个元素；单独查询公司查询时，其types数组包含4个元素。但同时查询两者时，员工查询的types数组被更新为包含4个元素而非原本的2个。查询语句示例：query GetEmployee ($id: ID!) { employee (id: $id) { id, companyTaskCate... }

问题根源 #

大多数GraphQL客户端（比如Apollo、Relay）会根据返回对象的__typename+唯一标识（比如id）做缓存归一化。如果员工的companyTaskCate.types和公司查询的types属于同一个__typename，缓存系统会认为这是同一批数据，后查询的结果会直接覆盖或合并掉之前的子集数据。

具体解决办法 #

1. 给字段添加别名（最快临时方案）

在同时查询时，给其中一个types字段设置别名，让客户端能明确区分两个不同的数据集：

query GetEmployeeAndCompany($employeeId: ID!, $companyId: ID!) {
  employee(id: $employeeId) {
    id
    companyTaskCate {
      # 给员工的types加专属别名
      employeeTaskTypes: types {
        id
        name
      }
    }
  }
  company(id: $companyId) {
    id
    # 公司的types保持原名
    types {
      id
      name
    }
  }
}

这样客户端缓存会把employeeTaskTypes和types当成两个独立字段，不会互相覆盖。

2. 定义差异化的GraphQL类型（长期架构方案）

如果业务上员工分类确实是公司分类的子集，建议在Schema中给它们定义不同的类型，哪怕字段结构完全一致——不同的__typename会让缓存系统彻底区分两者：

# 员工专属分类类型
type EmployeeTaskCategory {
  id: ID!
  name: String!
}

# 公司完整分类类型
type CompanyTaskCategory {
  id: ID!
  name: String!
}

type Employee {
  id: ID!
  companyTaskCate: {
    types: [EmployeeTaskCategory!]!
  }
}

type Company {
  id: ID!
  types: [CompanyTaskCategory!]!
}

这种方式从根源上避免了缓存歧义，也让Schema的语义更清晰。

3. 自定义客户端缓存标识规则（进阶方案）

如果用Apollo Client这类工具，可以通过dataIdFromObject函数给不同场景下的分类数据加上区分前缀，让缓存系统识别为不同实体：

const client = new ApolloClient({
  cache: new InMemoryCache({
    dataIdFromObject: (object) => {
      switch (object.__typename) {
        case 'TaskCategory':
          // 根据父级类型区分员工/公司分类
          if (object.__parentTypeName === 'EmployeeCompanyTaskCate') {
            return `employee-task-cate:${object.id}`;
          }
          return `company-task-cate:${object.id}`;
        default:
          return defaultDataIdFromObject(object);
      }
    },
  }),
});

这个方案需要你能识别数据的父级上下文，适合不想修改Schema的场景。

总结 #

优先用字段别名快速解决当前问题，如果是长期维护的项目，推荐定义差异化类型来避免后续同类问题。

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