Como corrigir o erro Unexpected token em JSON

A mensagem Unexpected token aparece quando o interpretador de JSON está lendo o texto caractere a caractere e encontra algo que não faz sentido naquela posição. A gramática do JSON é rígida sobre o que pode vir a seguir em cada ponto: depois de uma chave espera-se dois pontos, depois de um valor espera-se uma vírgula ou um fechamento, e assim por diante. Quando o próximo caractere não corresponde a nenhuma dessas possibilidades, a leitura para e o parser relata o token que o surpreendeu. Em muitos ambientes, a mensagem inclui o caractere problemático e a posição, como token inesperado na posição tal. Entender isso desmistifica o erro: ele não indica que o JSON inteiro está errado, apenas que há um ponto específico onde a estrutura desvia da gramática esperada.

As causas de um token inesperado são poucas e recorrentes. Uma aspa que não foi fechada faz o parser engolir o restante da linha como se fosse texto, até topar com um caractere inesperado. Uma vírgula a mais, como a vírgula final, ou uma vírgula que faltou entre dois itens desalinha toda a leitura. Aspas simples no lugar de aspas duplas geram o erro logo no início de uma chave ou valor. Caracteres soltos, como um ponto e vírgula copiado por engano, um colchete que não abriu ou um trecho de texto sem aspas, também disparam a mensagem. Outro clássico é receber HTML de uma página de erro quando se esperava JSON de uma API: o primeiro caractere, um sinal de menor, vira o token inesperado que denuncia que a resposta não era JSON.

Para transformar essa mensagem genérica em algo acionável, a ferramenta reporta a posição e o motivo do primeiro token que não encaixa, seguindo a lógica do JSON.parse. Em vez de reler o arquivo inteiro tentando adivinhar, você vai direto à posição indicada. Um detalhe importante: a posição marca onde a leitura falhou, mas a causa muitas vezes está um pouco antes. Uma aspa que faltou fecha lá atrás, e o parser só percebe o desencontro mais adiante. Por isso, ao investigar, examine o token apontado e também o item imediatamente anterior. Como a validação para no primeiro problema, corrigir e revalidar revela o próximo, se houver. Esse ciclo curto, de um erro por vez, é a forma mais confiável de limpar um JSON que acumulou vários pontos inesperados.

A correção depende do que causou o token inesperado, e conhecer os padrões acelera o trabalho. Se a posição cai sobre uma chave de fechamento e há uma vírgula logo antes, remova essa vírgula final. Se o erro surge no meio de um texto, procure uma aspa que não foi aberta ou fechada, ou aspas tipográficas curvas coladas de um documento. Se aparece logo no começo, confira se as aspas são duplas e não simples. Se o conteúdo começa com um sinal de menor, você provavelmente recebeu HTML em vez de JSON e precisa investigar a origem da resposta, não o texto. Em todos os casos, a ferramenta aponta e explica, mas a edição é sua: ela mostra o ponto e a razão, e você aplica a correção no editor antes de validar de novo.

Todo o processamento é local, dentro do navegador, então o JSON que gerou o token inesperado não é enviado para nenhum servidor. Isso permite depurar com segurança respostas de APIs internas e arquivos de configuração que carregam dados sensíveis. Vale reforçar as regras que evitam esse erro na origem: aspas duplas em chaves e strings, vírgulas apenas entre itens e nunca depois do último, ausência de comentários e fechamento correto de chaves e colchetes. Quando precisar de uma checagem além da sintaxe, você pode validar o JSON contra um JSON Schema fornecido, conferindo campos, tipos e restrições. Seja para caçar um único token teimoso ou para revisar um contrato de API inteiro, a validação continua gratuita, sem cadastro e sem marca d'água, ajudando você a resolver o erro e a entregar um JSON confiável.