GraphQL에서 오류 처리는 어떻게 동작하나요?

Question

IT Interview Practice · Accepted Answer

GraphQL은 transport가 성공하면 항상 HTTP **200**을 반환합니다; 문제는 상태 코드가 아니라 응답 본문에 보고됩니다. 응답에는 두 개의 최상위 key가 있습니다: **`data`**와 **`errors`**, 그리고 둘이 동시에 존재할 수 있습니다 — 이것이 **부분 데이터(partial data)**입니다.

## 부분 데이터 + errors 배열

한 필드의 resolver가 예외를 던지면 그 필드는 `null`이 되고 `errors`에 항목이 추가되지만, 다른 모든 필드는 여전히 resolve됩니다. 클라이언트는 성공한 것과 함께 실패한 것에 대한 설명을 받습니다.

```json
{
  "data": { "user": { "name": "Ada", "posts": null } },
  "errors": [
    {
      "message": "Failed to load posts",
      "path": ["user", "posts"],        // exactly which field failed
      "extensions": { "code": "DOWNSTREAM_TIMEOUT" }
    }
  ]
}
```

**`extensions.code`** 필드는 기계가 읽을 수 있는 오류 코드를 담아 클라이언트가 이를 기준으로 분기할 수 있게 합니다. 예외를 던진 필드가 자기 자신만 null로 만들지 아니면 상위로 전파되는지는 **nullability**에 달려 있습니다: 오류가 난 non-null 필드(`posts: [Post!]!`)는 대신 가장 가까운 nullable parent를 null로 만듭니다.

```js
import { GraphQLError } from "graphql";

많은 팀이 **예상된** 오류(검증, "이미 사용 중인 이메일")를 union/result 타입을 통해 schema의 일부로 모델링하고, `errors` 배열은 **예상치 못한** 실패에 남겨 둡니다 — 정상 경로(happy-path) 타이핑을 깔끔하게 유지하기 위해서입니다.

## 왜 중요한가

면접관은 여러분이 오류가 부분 `data`와 함께 본문에 들어 있다는 것, 코드는 `extensions`에 속한다는 것, 그리고 nullability가 오류가 어디까지 전파되는지를 제어한다는 것을 아는지 살핍니다. GraphQL 오류를 HTTP 상태 코드와 혼동하는 것은 REST만 써 본 사람이라는 전형적인 신호입니다.

부분 데이터 + errors 배열

왜 중요한가

관련 질문