NestJS GraphQL嵌套层级字段如何调用子对象已定义的resolver

核心实现逻辑 #

GraphQL 执行引擎本身会按照查询树分层递归调用对应对象类型的解析器，你完全不需要在父级 @ResolveField 中手动处理所有嵌套字段，只需要为每一层对象的关联字段单独编写解析逻辑即可，各层解析器只负责自己管辖的字段解析，互不干扰。

具体实现步骤 #

1. 编写 Person 解析器

只需要处理 Person 本身的基础字段查询，以及关联的 pet 字段解析，不需要处理 pet 下的 toy 字段：

import { Resolver, Query, Args, ResolveField, Parent } from '@nestjs/graphql';
import { Person } from './entities/person.entity';
import { PersonService } from './person.service';
import { Pet } from 'src/pet/entities/pet.entity';
import { PetService } from 'src/pet/pet.service';

@Resolver(() => Person)
export class PersonResolver {
  constructor(
    private readonly personService: PersonService,
    private readonly petService: PetService,
  ) {}

  @Query(() => Person, { name: 'person' })
  findOne(@Args('id') id: string) {
    // 仅返回Person基础字段：id、name、petId，无需处理pet关联
    return this.personService.findOne(id);
  }

  @ResolveField('pet', () => Pet)
  getPet(@Parent() person: Person) {
    // 仅根据当前Person的petId查询Pet基础数据（id、species、toyId），无需处理toy关联
    return this.petService.findOne(person.petId);
  }
}

2. 编写 Pet 解析器

只需要处理 Pet 关联的 toy 字段解析即可，不需要关联上层 Person 的逻辑：

import { Resolver, ResolveField, Parent } from '@nestjs/graphql';
import { Pet } from './entities/pet.entity';
import { Toy } from 'src/toy/entities/toy.entity';
import { ToyService } from 'src/toy/toy.service';

@Resolver(() => Pet)
export class PetResolver {
  constructor(private readonly toyService: ToyService) {}

  @ResolveField('toy', () => Toy)
  getToy(@Parent() pet: Pet) {
    // 仅根据当前Pet的toyId查询Toy数据，返回的color字段会自动匹配查询需求
    return this.toyService.findOne(pet.toyId);
  }
}

执行流程说明 #

你给出的查询语句会被自动分层执行：

1. 首先调用 PersonResolver 的 person 查询，拿到 Person 的 name、petId 字段
2. 因为查询声明了需要 pet 字段，自动调用 PersonResolver 的 getPet 方法，拿到 Pet 的 toyId 等基础字段
3. 因为查询声明了 pet 下需要 toy 字段，自动调用 PetResolver 的 getToy 方法，拿到 Toy 的 color 字段

所有嵌套解析都是 GraphQL 引擎自动调度的，不需要手动维护解析树。

常见疑问说明 #

官方示例都直接调用 Service 而不是其他 Resolver 是符合架构规范的：Resolver 是 GraphQL 层的入口封装，核心业务逻辑本来就应该下沉到 Service 层实现，跨模块调用 Service 可以避免 GraphQL 层逻辑耦合，也是 NestJS 推荐的分层实践。如果担心嵌套查询带来的 N+1 性能问题，可以集成 DataLoader 做批量查询优化。

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