JSON: erros comuns de sintaxe e como evitá-los

JSON (JavaScript Object Notation) é o formato de troca de dados mais usado em APIs modernas — e também uma fonte constante de erros de sintaxe frustrantes, principalmente quando o JSON foi escrito ou editado manualmente. Aqui estão os erros mais comuns e como identificá-los rapidamente.

1. Vírgula sobrando antes de } ou ]

{
  "nome": "João",
  "idade": 30,
}

Essa vírgula depois de 30 parece inofensiva, mas o JSON não permite vírgulas "penduradas" (trailing commas) como o JavaScript permite em alguns contextos. Remova a vírgula do último item de um objeto ou array.

2. Aspas simples em vez de duplas

{ 'nome': 'João' }

JSON exige aspas duplas (") para chaves e valores de texto — aspas simples não são válidas, mesmo que funcionem em JavaScript puro. Essa é uma das causas mais comuns de erro ao copiar objetos JavaScript diretamente como se fossem JSON.

3. Chaves ou colchetes não fechados

{
  "usuario": {
    "nome": "João"
}

Fácil de perder o controle em estruturas aninhadas grandes. Um bom formatador aponta exatamente em qual posição a estrutura ficou incompleta, em vez de só dizer "JSON inválido".

4. Chaves sem aspas

{ nome: "João" }

Diferente de JavaScript, onde chaves de objeto podem ficar sem aspas em certos casos, JSON exige que toda chave esteja entre aspas duplas.

5. Comentários

{
  // isso não é válido em JSON
  "nome": "João"
}

JSON não suporta comentários, ao contrário de JSON5 ou JSONC (usado em alguns arquivos de configuração). Se você colou um .jsonc esperando JSON puro, é aqui que o erro aparece.

Encontrando o erro rapidamente

Em vez de caçar esses problemas manualmente linha por linha, cole o JSON no nosso Formatador de JSON — ele identifica o erro exato de sintaxe e, quando o JSON é válido, reformata tudo com indentação legível em um clique.