Como funciona o tratamento de erros no GraphQL?

Question

IT Interview Practice · Accepted Answer

O GraphQL sempre retorna HTTP **200** para um transporte bem-sucedido; os problemas são reportados no corpo da resposta, não no status code. Uma resposta tem duas chaves de topo: **`data`** e **`errors`**, e ambas podem estar presentes ao mesmo tempo — isso é **dado parcial**.

## Dado parcial + o array de errors

Se o resolver de um campo lança uma exceção, aquele campo vira `null`, uma entrada é adicionada a `errors`, mas todos os outros campos ainda resolvem. O cliente recebe o que teve sucesso mais uma descrição do que falhou.

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

O campo **`extensions.code`** carrega um código de erro legível por máquina para que os clientes possam ramificar a lógica com base nele. Se um campo que lança exceção anula apenas a si mesmo ou propaga para cima depende da **nullability**: um campo non-null (`posts: [Post!]!`) que dá erro anula o parent nullable mais próximo.

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

Muitas equipes também modelam erros **esperados** (validação, "e-mail já em uso") como parte do schema via union/result types, reservando o array `errors` para falhas **inesperadas** — mantendo a tipagem do caminho feliz limpa.

## Por que isso importa

Os entrevistadores investigam se você sabe que os erros vivem no corpo com `data` parcial, que os códigos pertencem a `extensions` e que a nullability controla até onde um erro se propaga. Confundir erros do GraphQL com status codes HTTP é um sinal clássico de quem só usou REST.

Dado parcial + o array de errors

Por que isso importa

Perguntas relacionadas