Como Validar JSON: Erros Comuns e Correções

A sua API devolve um erro 400. O registo diz "Invalid JSON." Fica a olhar para o payload e tudo parece correto — até descobrir a aspa simples escondida na linha 47. Os erros de validação JSON são frustrantes precisamente porque são frequentemente pequenos erros que estragam tudo.

Os Erros de Sintaxe JSON Mais Comuns

1. Vírgulas no Final

O erro JSON número um. O JavaScript aceita vírgulas no final, por isso os programadores levam o hábito para o 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

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

3. Chaves Sem Aspas

Todas as chaves em JSON devem ser cadeias de caracteres entre aspas. {name: "Alex"} deve ser {"name": "Alex"}.

4. Vírgulas em Falta Entre Elementos

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

5. Parênteses Incompatíveis

Abrir um { mas fechar com ], ou aninhar incorretamente. Utilize um Validador de JSON que destaque os parênteses correspondentes.

Como Validar JSON Eficazmente

Validação Manual Rápida

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

Validação Programática

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

Validação de Schema

A validação de sintaxe indica-lhe que o JSON está bem formado. A validação de schema indica-lhe que tem a estrutura correta. Utilize o nosso Validador de JSON Schema para definir as formas esperadas.

Depuração de Erros JSON Passo a Passo

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

Configurar Validação Automatizada

No Seu Editor

Ative o destaque de sintaxe JSON, linters e validação de schema para ficheiros de configuração.

No Seu Pipeline de CI

Adicione validação JSON ao seu processo de compilação para detetar erros antes de serem integrados.

Na Sua API

Nunca confie em JSON recebido. Valide tanto a sintaxe como o schema na fronteira da sua API. Devolva mensagens de erro úteis.

Perguntas Frequentes

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

A validação JSON verifica a sintaxe (aspas corretas, parênteses, vírgulas). A validação de JSON Schema verifica a estrutura — campos corretos, tipos corretos, restrições corretas.

Porque é que o meu JSON funciona em JavaScript mas falha noutros parsers?

O JavaScript é mais tolerante do que a especificação JSON. Permite vírgulas no final, aspas simples e comentários. Os parsers rigorosos rejeitam todos estes.

Recursos Relacionados

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