如何将含一对多关系的嵌套JSON转换为合适Schema？

针对你这种School→Class→Student的一对多嵌套结构，直接照搬JSON的嵌套层级设计GraphQL Schema确实容易绕进去。其实GraphQL更适合用实体类型+关联字段的方式来拆解这种关系，既清晰又灵活，下面给你一步步的解决方案：

1. 设计对应的GraphQL Schema #

我们可以把每个层级拆成独立的类型，然后通过字段关联表达一对多/多对一关系，而不是嵌套到底：

# 最底层的Student类型，关联所属的Class和School
type Student {
  name: ID! # 用你的示例中的name作为唯一标识，也可以单独加id字段
  propertyA: String
  class: Class! # 多对一：Student属于一个Class
  school: School! # 多对一：Student属于一个School
}

# Class类型，包含关联的Student列表和所属的School
type Class {
  name: ID!
  students: [Student!]! # 一对多：一个Class有多个Student
  school: School! # 多对一：Class属于一个School
}

# School类型，包含关联的Class列表
type School {
  id: ID!
  name: String!
  classes: [Class!]! # 一对多：一个School有多个Class
}

# 查询入口，定义获取各实体的方式
type Query {
  schools: [School!]! # 获取所有学校
  school(id: ID!): School # 根据id获取单个学校
  classes: [Class!]! # 获取所有班级
  class(name: ID!): Class # 根据name获取单个班级
  students: [Student!]! # 获取所有学生
  student(name: ID!): Student # 根据name获取单个学生
}

2. 编写Resolver处理关联查询 #

用Apollo Server的话，你需要编写Resolver来处理这些关联字段，把分散的实体数据关联起来。比如用内存数据做示例：

// 先把原JSON拆成分散的实体集合（实际项目可能从数据库/API获取）
const data = {
  schools: [{ id: 1, name: "Grad School" }],
  classes: [{ name: 101, schoolId: 1 }],
  students: [{ name: 501, propertyA: "test", classId: 101, schoolId: 1 }]
};

const resolvers = {
  // 处理School的classes字段：返回该学校下的所有班级
  School: {
    classes(parent) {
      return data.classes.filter(cls => cls.schoolId === parent.id);
    }
  },
  // 处理Class的students和school字段
  Class: {
    students(parent) {
      return data.students.filter(student => student.classId === parent.name);
    },
    school(parent) {
      return data.schools.find(school => school.id === parent.schoolId);
    }
  },
  // 处理Student的class和school字段
  Student: {
    class(parent) {
      return data.classes.find(cls => cls.name === parent.classId);
    },
    school(parent) {
      return data.schools.find(school => school.id === parent.schoolId);
    }
  },
  // 处理根查询
  Query: {
    schools() {
      return data.schools;
    },
    school(_, { id }) {
      return data.schools.find(school => school.id === id);
    }
    // 其他查询的Resolver可以类似补充
  }
};

3. 灵活的查询示例 #

现在你可以用GraphQL查询灵活获取需要的层级，比如想查某学校下的所有班级和学生：

query GetSchoolDetails {
  school(id: 1) {
    name
    classes {
      name
      students {
        name
        propertyA
      }
    }
  }
}

返回的结果结构就和你原来的JSON一致，但你也可以只查学生所属的学校，不需要嵌套所有层级，非常灵活。

工具辅助转换的小建议 #

如果想快速生成基础类型，可以用一些JSON转GraphQL Schema的在线工具，但这类工具没法自动识别实体间的关联关系，所以生成后需要手动添加关联字段（比如class: Class!、students: [Student!]!），调整成上面的结构才好用。

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