Corrigir JSON inválido: descubra a causa e como ajustar

Antes de corrigir, é preciso saber o que quebrou. A ferramenta valida o seu JSON com a mesma lógica do JSON.parse, para no primeiro problema e mostra a posição e a causa. A partir daí, a correção é feita por você, e essa é uma escolha deliberada: uma correção automática poderia remover uma vírgula ou trocar uma aspa e, sem querer, alterar o significado dos seus dados. Ao apontar o ponto e explicar o motivo, a ferramenta lhe dá exatamente o que falta para consertar com confiança, mantendo você no controle de cada mudança. A boa notícia é que a imensa maioria dos JSON inválidos cai em um punhado de causas repetidas. Conhecer esse punhado torna a correção quase mecânica, mesmo em documentos grandes e aninhados.

A causa mais frequente é a vírgula final. Em JSON, a vírgula separa itens e não pode aparecer depois do último elemento de um objeto ou de um array. Um objeto ou lista terminado em vírgula, como uma sequência com vírgula antes do fechamento, invalida o documento, mesmo que o JavaScript aceite isso sem reclamar. A correção é simplesmente remover a vírgula que sobra antes do fechamento. A segunda causa mais comum são as aspas simples. O JSON só reconhece aspas duplas, tanto em chaves quanto em strings, então um campo entre aspas simples precisa passar a usar aspas duplas. Esses dois erros costumam vir juntos em texto copiado de código JavaScript ou de um console, e a ferramenta aponta cada ocorrência para você trocar as aspas e apagar a vírgula excedente no ponto exato indicado.

A terceira causa clássica são as chaves sem aspas. Em objetos JavaScript é permitido escrever a chave sem aspas, mas em JSON toda chave precisa de aspas duplas, virando algo como "nome": "Ana". A ferramenta sinaliza a chave desprotegida para você envolvê-la em aspas. A quarta causa são as chaves e colchetes não fechados. Cada abertura de objeto pede o fechamento correspondente e cada abertura de array também, sempre respeitando a ordem do aninhamento. Um fechamento esquecido faz o parser chegar ao fim do texto ainda esperando por ele, gerando a mensagem de fim inesperado do JSON. Nesse caso, o conserto é adicionar o fechamento que falta na posição certa, ou remover o de abertura que sobrou. Contar as aberturas e os fechamentos, ajudado pela posição apontada, resolve o problema.

Além desse quarteto, há causas menos óbvias que também invalidam o JSON. Valores que existem em JavaScript mas não em JSON, como undefined, NaN e Infinity, precisam ser substituídos por um valor permitido ou por null. Aspas duplas e barras invertidas dentro de uma string devem ser escapadas com barra invertida, e uma aspa não escapada faz o parser achar que a string terminou antes da hora. Caracteres de controle, como quebras de linha literais dentro de uma string, também não são aceitos. Às vezes o culpado é invisível, como um caractere de marca de ordem de bytes no início do arquivo ou espaços fora do lugar. Em todos esses casos, o diagnóstico aponta onde o parsing falhou, e a correção segue o mesmo ritmo: ajustar o ponto indicado e validar de novo.

Vale reforçar que todo o diagnóstico acontece localmente, dentro do navegador. O seu JSON não é enviado a servidor nenhum, não fica armazenado e não trafega pela rede, o que permite corrigir documentos com dados sensíveis sem qualquer exposição. Como não há upload, o retorno é imediato mesmo em arquivos grandes. O fluxo de trabalho para deixar um JSON válido é direto e vale a repetição: cole o texto, leia qual é a causa e onde está, faça o ajuste diretamente na caixa e valide de novo. A cada rodada, uma causa é eliminada e a seguinte aparece, até o documento ser aceito. Como as causas se repetem, poucas passagens costumam bastar, e você termina com um JSON válido que qualquer parser, em qualquer linguagem, vai aceitar sem reclamar.