Erros de análise de JSON: leia a mensagem, vá direto à correção

Um diretório de mensagens de erro dos analisadores de JSON e do artigo que explica cada uma — comece com um validador rigoroso e depois aprofunde no problema de sintaxe específico.

Quando você chega aqui

Seu código lançou um erro do analisador de JSON e você quer encontrar a correção exata. Comece lendo a mensagem do analisador — a posição e o caractere suspeito são pistas. Depois vá ao artigo que explica o erro subjacente e use o validador rigoroso para confirmar que o texto reparado passa pelo JSON.parse sem problemas.

Validar a sintaxe do JSON (rigoroso, linha + coluna)Reparar JSON inválido no seu navegador

Leia a mensagem do analisador

Todo analisador de JSON moderno informa uma posição e o caractere problemático. Compare a mensagem com esta lista e abra o artigo que cobre exatamente essa formulação.

Erros Unexpected token — visão geralUnexpected token < — seu fetch retornou HTMLUnexpected token u — você analisou undefinedUnexpected token o — [object Object] foi serializadoUnexpected end of JSON input — truncado ou não fechadoCaractere não branco após o JSON — dados a mais, NDJSON?String não terminada em JSON — aspas abertas mas nunca fechadasCaractere de escape inválido em JSON — \x, caminhos do WindowsCaractere de controle inválido em literal de string — tab/quebra de linha bruta[object Object] não é JSON válidoEsperado nome de propriedade entre aspas duplas — vírgula final

Corrija o erro subjacente

A maioria dos erros do analisador vem de um de cinco problemas de sintaxe recorrentes. O guia de cada um explica a causa, a correção e o que verificar antes de executar o analisador novamente.

Corrigir vírgulas finais em JSONCorrigir aspas simples em JSONCorrigir chaves sem aspas em JSONCorrigir erros Unexpected Token (guia)Corrigir erros Expected Property Name

Por que o JSON rigoroso é rigoroso

O JSON se parece com um literal de objeto JavaScript, mas é uma gramática muito menor. Sem vírgulas finais, sem comentários, sem aspas simples, sem True/None no estilo do Python. As referências históricas explicam por que a gramática permaneceu mínima e como as decisões de interoperabilidade foram tomadas.

RFC 8259 — padrão atual do JSONECMA-404 segunda ediçãoParsing JSON is a Minefield (divergência entre analisadores)Bishop Fox — pesquisa sobre interoperabilidade de JSONGramática JSON do Tree-sitter — por que seu editor analisa de forma diferente do JSON.parse

Caminho recomendado

Da ferramenta ao guia, ao blog e à referência, em uma única sequência: abra o validador de JSON para obter a linha e a coluna exatas, leia o guia do erro subjacente, siga o artigo do blog vinculado a essa mensagem de erro e depois consulte o padrão que define a gramática.

    1. Ferramenta: /json-validate — confirme o erro de análise e sua posição.
    1. Guia: /guides/fix-json-unexpected-token — relacione o sintoma à causa.
    1. Blog: /blog/json-parse-unexpected-token — detalhamento completo dos erros em nível de token.
    1. Referência: /news/rfc-8259-json-standard — por que a gramática é rigorosa.
Abrir Corrigir JSONComparar alterações de JSON

Guias de reparação de JSON

Núcleos temáticos

  1. Reparar JSON inválido: de «o que está errado» a um arquivo limpo
  2. Formatador, validador e visualizador de JSON: escolha a ferramenta certa
  3. Reparar a saída JSON de um LLM: lidar com o quase-JSON da IA
  4. Privacidade: ferramentas JSON que não saem do seu navegador
  5. Interoperabilidade de JSON: YAML, CSV, XML, JWT, Schema

Guias específicos

  1. Como decodificar strings Base64 (e payloads JWT)
  2. Codificação URL: codifique parâmetros de consulta e caminhos
  3. Converter YAML para JSON (e evitar erros de indentação)
  4. Converter JSON para CSV: achatar um array de objetos
  5. Converter JSON para XML: raiz, atributos e arrays
  6. Escapar JSON como literal de string (e decodificar JSON com codificação dupla)
  7. Corrigir vírgulas finais em JSON
  8. Corrigir aspas simples em JSON
  9. Corrigir chaves sem aspas em JSON
  10. Reparar JSON gerado por LLM
  11. Corrigir o erro de parse JSON: Expected Property Name
  12. JSON x literal de objeto JavaScript
  13. Valide o JSON antes das requisições de API
  14. Formatador JSON x JSON Repair
  15. Corrigir erros JSON Unexpected Token
  16. Conversor de JSON para objeto JavaScript