GraphQL查询报错：Unknown field 'employee' 问题排查求助

核心问题：缺少根Query类型 #

GraphQL要求所有客户端可调用的顶层查询字段必须定义在type Query根类型下，你的schema仅定义了Employee对象类型，没有提供查询入口，所以IDE无法识别employee这个顶层查询字段。

修复步骤 #

1. 更新schema.graphql
   添加根Query类型，定义获取部门员工的字段（建议用复数employees更符合语义，返回员工列表）：

   type Employee {
       username: String!
       fullName: String!
       lastName: String!
   }
   
   type Query {
       # 根据部门ID获取员工列表
       employees(departmentId: ID): [Employee!]!
   }
   

2. 调整查询代码
   对应schema里的字段名修改查询（如果schema用了employees，查询里也要同步）：

   export const QUERY_DEPARTMENT_EMPLOYEES = gql`
       query Employees($departmentId: ID) {
           employees(departmentId: $departmentId) {
               ...EmployeeFields
           }
       }`
   

额外说明 #

你的graphql.config.yml设置documents: []是指定不加载外部查询文件，当前问题和这个配置无关，无需调整。只要schema正确定义根Query类型，IDE的错误提示就会消失。

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