Como corrigir a vírgula final que invalida o JSON

A vírgula final, ou trailing comma, é aquela que aparece logo depois do último item de um objeto ou de um array, antes da chave ou do colchete de fechamento. Em JavaScript moderno, ela é permitida e até incentivada, porque facilita reordenar linhas e gera diffs mais limpos no controle de versão. O JSON, porém, segue uma gramática mais estrita e não aceita essa vírgula. O formato foi projetado para ser um subconjunto simples e previsível, em que a vírgula serve apenas para separar dois itens. Se não há um próximo item, não pode haver vírgula. Por isso, um objeto ou array que funciona perfeitamente em um arquivo de código JavaScript pode ser rejeitado assim que você o trata como JSON puro, e a causa quase sempre é essa vírgula sobrando no fim.

Esse erro costuma surgir durante a edição manual. Você remove o último campo de um objeto e esquece de apagar a vírgula que ficou pendurada no campo anterior. Ou comenta temporariamente uma linha e deixa a vírgula acima sem par. Também é comum ao montar JSON concatenando strings em código, quando o laço adiciona uma vírgula após cada item, inclusive o último. Ferramentas de exportação mal configuradas e cópias parciais feitas a partir de arquivos maiores completam a lista de origens frequentes. Em todos esses casos, a estrutura parece correta a olho nu, porque a vírgula é um caractere pequeno e discreto. É justamente por passar despercebida que a vírgula final aparece tanto em respostas de API montadas à mão e em arquivos de configuração editados às pressas antes de um deploy.

A ferramenta ajuda a caçar essa vírgula reportando o primeiro erro da estrutura com a posição e o motivo, seguindo a lógica do JSON.parse. No caso da vírgula final, o interpretador percebe o problema quando encontra a chave ou o colchete de fechamento logo após a vírgula, esperando outro item que não existe. Por isso, a posição indicada costuma cair sobre o caractere de fechamento ou muito perto dele. A dica prática é: ao ver o erro apontado junto de um fechamento, olhe o caractere imediatamente anterior. Se for uma vírgula, é ela que sobra. Como a ferramenta para no primeiro problema, pode haver mais de uma vírgula final no arquivo. Depois de remover a primeira e revalidar, a próxima aparece, e você repete o processo até tudo ficar limpo.

Corrigir é simples: basta apagar a vírgula que vem depois do último elemento. Mas vale um cuidado ao editar, para não criar um novo problema. Ao remover um item do meio de uma lista, garanta que os itens restantes continuem separados por vírgula. Ao remover o item final, apague também a vírgula do item que agora passou a ser o último. Um bom hábito é formatar o JSON com indentação antes de mexer, porque o alinhamento deixa evidente onde cada objeto e array começa e termina. Seja honesto quanto ao papel da ferramenta: ela aponta e explica o erro, mas não edita o texto por você. Ela mostra onde está a vírgula sobrando, e a remoção é feita no seu editor. Depois, revalidar confirma que a correção resolveu o problema.

Todo esse processo acontece localmente, dentro do navegador, sem que o seu JSON seja enviado para qualquer servidor. Isso é importante quando o conteúdo com a vírgula problemática inclui dados de configuração sensíveis ou respostas de APIs internas. Além da vírgula final, vale conferir de passagem as outras regras que costumam andar juntas: aspas duplas em chaves e strings, ausência de comentários e fechamento correto de chaves e colchetes. Não raro, o mesmo arquivo editado à mão acumula mais de um desses deslizes. Se você precisar de uma validação mais rigorosa, ainda é possível verificar o JSON contra um JSON Schema fornecido, conferindo campos e tipos além da sintaxe. Em qualquer cenário, a validação é gratuita, sem cadastro e sem marca d'água, ajudando você a entregar um JSON limpo antes do deploy.