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
- Formate primeiro — Cole num Formatador de JSON para obter indentação adequada
- Verifique a posição do erro — A maioria dos parsers reporta a linha e a coluna
- Procure os suspeitos habituais — Vírgulas no final, aspas simples, chaves sem aspas
- Valide incrementalmente — Para JSON grande, valide secções separadamente
- 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.
Regras Fundamentais de Formatação JSON
Utilizar Indentação Consistente
Escolha 2 espaços ou 4 espaços e mantenha essa escolha em todo o projeto. Tabulações também funcionam, mas os espaços são mais universalmente suportados em ferramentas JSON.
{
"user": {
"name": "Alex Chen",
"email": "[email protected]",
"roles": ["admin", "editor"]
}
}
Utilizar Sempre Aspas Duplas
O JSON requer aspas duplas tanto para chaves como para valores de string. Aspas simples causarão erros de parsing em todos os parsers JSON rigorosos.
Manter Nomes de Chaves Consistentes
Escolha uma convenção de nomenclatura e aplique-a em todo o lado. camelCase é a mais comum em ecossistemas JavaScript, enquanto snake_case é popular em APIs baseadas em Python.
Trabalhar com Ficheiros JSON Grandes
Ficheiros JSON grandes necessitam de atenção especial:
- Utilizar um editor JSON dedicado — O nosso Editor JSON lida com ficheiros grandes com destaque de sintaxe
- Formatar antes de comparar — Utilize uma ferramenta de JSON Diff para identificar alterações reais
- Extrair dados com JSONPath — As consultas JSONPath são mais rápidas do que a pesquisa manual
Recursos Relacionados
- 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
🛠️ Experimente agora: JSON Validator — 100% gratuito, tudo processado no seu navegador. Sem upload de dados.