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
- Formate primeiro — Cole em um Formatador JSON para obter indentação adequada
- Verifique a posição do erro — A maioria dos parsers reporta linha e coluna
- Procure os suspeitos habituais — Vírgulas finais, aspas simples, chaves sem aspas
- Valide incrementalmente — Para JSON grande, valide seções separadamente
- 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.
Regras Fundamentais de Formatação JSON
Use Indentação Consistente
Escolha entre 2 espaços ou 4 espaços e mantenha isso em todo o seu projeto. Tabs também funcionam, mas espaços são mais universalmente suportados em ferramentas JSON.
{
"user": {
"name": "Alex Chen",
"email": "[email protected]",
"roles": ["admin", "editor"]
}
}
Sempre Use Aspas Duplas
JSON exige aspas duplas para chaves e valores de string. Aspas simples causarão erros de parsing em todo parser JSON estrito.
Mantenha os Nomes de Chaves Consistentes
Escolha uma convenção de nomenclatura e aplique em todos os lugares. camelCase é a mais comum em ecossistemas JavaScript, enquanto snake_case é popular em APIs baseadas em Python.
Trabalhando com Arquivos JSON Grandes
Arquivos JSON grandes exigem atenção especial:
- Use um editor JSON dedicado — Nosso Editor JSON lida com arquivos grandes com destaque de sintaxe
- Formate antes de comparar — Use uma ferramenta de JSON Diff para identificar mudanças reais
- Extraia dados com JSONPath — Consultas JSONPath são mais rápidas que busca manual
Recursos Relacionados
- 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
🛠️ Experimente agora: JSON Validator — 100% gratuito, tudo processado no seu navegador. Sem upload de dados.