NestJSでGraphQL APIをどのように構築しますか?

Question

Accepted Answer

NestJSは`@nestjs/graphql`（Apollo Serverに基づく）を通じて、**GraphQL**に対する最高レベルのサポートを提供します。**コードファースト**アプローチ（TypeScriptクラスとデコレータでスキーマを定義し、スキーマを自動生成）を提供しており、これはNestJSのデコレータ/DIモデルに適合したイディオマティックな方法です。

## GraphQLのセットアップ（コードファースト）

```ts
@Module({
  imports: [
    GraphQLModule.forRoot<ApolloDriverConfig>({
      driver: ApolloDriver,
      autoSchemaFile: "schema.gql",   // code-first: auto-generate the schema from classes
      playground: true,                // interactive query explorer in dev
    }),
  ],
})
export class AppModule {}
```

## オブジェクトタイプ（デコレータで定義されるスキーマ）

```ts
@ObjectType()                        // a GraphQL type
export class User {
  @Field(() => ID) id: string;
  @Field() name: string;
  @Field() email: string;
  @Field(() => [Post]) posts: Post[];   // related type
}
```

コードファーストでは、デコレートされたクラス（`@ObjectType`、`@Field`）がスキーマを定義します。TypeScriptの型がGraphQLスキーマを自動生成し、それらの同期を保ちます。

## リゾルバー（クエリと変更）

```ts
@Resolver(() => User)
export class UsersResolver {
  constructor(private usersService: UsersService) {}   // DI works as usual

@Query(() => [User])               // a query: returns a list of users
  users() {
    return this.usersService.findAll();
  }

@Query(() => User)
  user(@Args("id") id: string) {     // query with an argument
    return this.usersService.findOne(id);
  }

@Mutation(() => User)              // a mutation: creates a user
  createUser(@Args("input") input: CreateUserInput) {
    return this.usersService.create(input);
  }
}
```

リゾルバー（GraphQL向けのコントローラーのようなもの）は`@Query`と`@Mutation`ハンドラーを定義し、DI経由でサービスに委譲します。これはRESTコントローラーと同じパターンです。

## 関連フィールドの解決（N+1問題の回避）

```ts
@ResolveField(() => [Post])         // resolve User.posts on demand
posts(@Parent() user: User) {
  return this.postsService.findByUser(user.id);
}
// ⚠️ for lists, this can cause N+1 queries → use DataLoader to BATCH them
```

`@ResolveField`は関連/ネストされたフィールドを遅延的に解決します。しかし、リストの場合、**N+1クエリ問題**のリスクがあり、DataLoaderバッチ処理で解決されます。

## GraphQL対REST トレードオフ

```text
GraphQL: clients request EXACTLY the fields they need (no over/under-fetching),
         one endpoint, strongly typed, great for complex/nested data & varied clients
REST:    simpler, better HTTP caching, well-understood — fine for straightforward APIs
→ Choose based on needs, not hype. NestJS supports both equally well.
```

## なぜ重要なのか

NestJSの最高レベルのGraphQLサポートは重要です。クライアントが必要なデータを正確に取得できるというGraphQLの利点（オーバーフェッチングとアンダーフェッチングを排除）、単一の強い型付けエンドポイント、複雑/ネストされたデータの優れた処理をNestJSの親しみやすく構造化されたモデルにもたらすからです。

nestJSの**コードファースト**アプローチ（TypeScriptクラスと`@ObjectType`/`@Field`/`@Resolver`デコレータでスキーマを定義し、スキーマを自動生成して同期を保つ）の理解は、シニアレベルの知識として重要です。このアプローチはNestJSのデコレータ/DIアーキテクチャに自然に適合します。リゾルバーはコントローラーと同じように動作し、注入されたサービスに委譲します。

型、クエリ、変更、解決されたフィールドの定義方法、そしてネストされたデータの**N+1クエリ問題**（およびその解決策としてのDataLoader）に対する認識は、キーとなるシニアレベルの知識です。

同様に重要なのは、**GraphQL対RESTのトレードオフ**を理解し、特定のプロジェクト向けに正しいアプローチを選択することです（複雑で柔軟なマルチクライアントのデータニーズにはGraphQL、シンプルなAPI且つ強力なHTTPキャッシングにはREST）。

GraphQLは主要なAPIパラダイムであり、NestJSの洗練された統合により、それは柔軟で効率的なバックエンドを構築するための重要で頻繁に関連する機能です。