Como Validar JSON: Erros Comuns e Correções

Sua API retorna um erro 400. O log diz "Invalid JSON." Você olha para o payload e tudo parece normal — até encontrar a aspa simples escondida na linha 47. Erros de validação JSON são frustrantes justamente porque são frequentemente erros minúsculos que quebram tudo.

Os Erros de Sintaxe JSON Mais Comuns

1. Vírgulas Finais

O erro JSON número um. JavaScript aceita vírgulas finais, então desenvolvedores carregam o hábito para JSON onde é inválido.

{
  "name": "Alex",
  "age": 30
}

Remova a vírgula após o último valor. Sempre.

2. Aspas Simples em Vez de Aspas Duplas

JSON requer aspas duplas. Isso é JavaScript válido mas JSON inválido: {'name': 'Alex'}. Substitua todas as aspas simples por aspas duplas.

3. Chaves Sem Aspas

Toda chave em JSON deve ser uma string entre aspas. {name: "Alex"} deveria ser {"name": "Alex"}.

4. Vírgulas Faltando Entre Elementos

Fácil de perder ao editar JSON manualmente — esquecer a vírgula entre pares chave-valor.

5. Colchetes Incompatíveis

Abrir um { mas fechar com ], ou aninhar incorretamente. Use um Validador JSON que destaque colchetes correspondentes.

Como Validar JSON Efetivamente

Validação Manual Rápida

Cole seu JSON no nosso Validador JSON. Ele destaca a linha exata e posição do caractere de qualquer erro. Todo o processamento acontece no seu navegador — seus dados nunca saem da sua máquina.

Validação Programática

Para aplicações, valide JSON em cada fronteira. Em JavaScript, envolva JSON.parse() em um try-catch. Em Python, use json.loads() com tratamento de exceção.

Validação de Schema

Validação de sintaxe diz que o JSON é bem-formado. Validação de schema diz que ele tem a estrutura correta. Use nosso Validador de JSON Schema para definir estruturas esperadas.

Depurando Erros JSON Passo a Passo

1. Formate primeiro — Cole em um Formatador JSON para obter indentação adequada
2. Verifique a posição do erro — A maioria dos parsers reporta linha e coluna
3. Procure os suspeitos habituais — Vírgulas finais, aspas simples, chaves sem aspas
4. Valide incrementalmente — Para JSON grande, valide seções separadamente
5. Compare versões — Use JSON Diff contra uma versão funcional

Configurando Validação Automatizada

No Seu Editor

Ative realce de sintaxe JSON, linters e validação de schema para arquivos de configuração.

No Seu Pipeline de CI

Adicione validação JSON ao seu processo de build para detectar erros antes do merge.

Na Sua API

Nunca confie em JSON de entrada. Valide tanto sintaxe quanto schema na fronteira da sua API. Retorne mensagens de erro úteis.

Perguntas Frequentes

Qual a diferença entre validação JSON e validação de JSON Schema?

Validação JSON verifica sintaxe (aspas, colchetes, vírgulas corretos). Validação de JSON Schema verifica estrutura — campos certos, tipos certos, restrições certas.

Por que meu JSON funciona em JavaScript mas falha em outros parsers?

JavaScript é mais permissivo que a especificação JSON. Ele aceita vírgulas finais, aspas simples e comentários. Parsers estritos rejeitam tudo isso.

Recursos Relacionados

• Boas Práticas de Formatação JSON — escreva JSON mais limpo desde o início
• Guia de Validação JSON Schema — imponha contratos de dados
• Ferramenta Validador JSON — valide sintaxe JSON instantaneamente
• Ferramenta Formatador JSON — embeleze e corrija formatação JSON