GraphQL多ID查询标准及通过roleId查询所属公司最佳实践咨询

你当前设计的companyByRoleId不属于通用场景下的最优方案，更符合GraphQL设计理念的是基于实体反向关联的嵌套查询方案。

现有方案的核心问题 #

你现在的设计思路是每新增一种查询场景就新增一个根查询字段，后续如果业务扩展，需要查询的关联组合变多，根查询字段会无限膨胀，比如后续可能要加roleByUserId、userCountByCompanyId等大量定制化字段，维护成本极高，也不符合GraphQL的图查询设计初衷。

更合适的实现方式 #

只需要在现有实体类型中补充反向关联字段，根查询保留通用的单实体查询入口即可，具体改造如下：

优化后的Schema定义 #

type Company {
  id: ID!
  name: String
  roles: Role[]
}

type Role {
  id: ID!
  name: String
  users: User[]
  company: Company! # 新增所属公司的反向关联字段
}

type User {
  id: ID!
  name: String
  role: Role! # 新增所属角色的反向关联字段
  company: Company! # 可选：新增所属公司的穿透关联字段，也可以直接通过role.company获取
}

type Query {
  # 仅保留3个通用实体查询入口，覆盖所有关联查询场景
  company(id: ID!): Company
  role(id: ID!): Role
  user(id: ID!): User
}

对应的查询示例 #

通过role ID查询所属公司，直接嵌套取字段即可：

query($roleId: ID!) {
  role(id: $roleId) {
    company {
      id
      name
    }
    # 还可以同时按需取角色名、关联用户列表等其他字段，无需新增查询接口
    name
    users {
      id
      name
    }
  }
}

通过user ID查询所属公司的写法同理：

query($userId: ID!) {
  user(id: $userId) {
    company {
      id
      name
    }
  }
}

特殊场景下可以保留companyByRoleId类字段 #

如果你的业务符合以下两种情况之一，可以保留定制化根查询字段：

• 该查询是业务超高频率的核心场景，单独做根查询可以针对性优化数据库查询逻辑，降低性能损耗
• 该查询有独立的鉴权规则，和普通查询role、company的权限逻辑不一致，单独做字段方便做权限控制

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