5 Erros Comuns de Sintaxe JSON e Como Corrigi-los

# 5 Erros Comuns de Sintaxe JSON e Como Corrigi-los

O JSON é simples, mas sua rigidez faz com que um único caractere fora do lugar invalide todo o documento. Aqui estão os 5 erros que mais frustram os desenvolvedores e como resolvê-los.

---

1. Vírgulas no Final (Trailing Commas)

Diferente do JavaScript moderno, o JSON proíbe terminantemente o uso de vírgulas após o último item de uma lista ou objeto.

❌ Errado

{
  "nome": "Alice",
  "ativo": true,
}

✅ Correto

{
  "nome": "Alice",
  "ativo": true
}

---

2. Aspas Simples vs Duplas

O padrão JSON aceita apenas aspas duplas (") para chaves e valores de texto.

❌ Errado

{
  'id': 'usuario_123'
}

✅ Correto

{
  "id": "usuario_123"
}

---

3. Chaves sem Aspas

No JavaScript, você pode omitir aspas nas chaves, mas no JSON elas são obrigatórias e devem ser aspas duplas.

❌ Errado

{
  pontuacao: 100
}

✅ Correto

{
  "pontuacao": 100
}

---

4. Caracteres de Escape Inválidos

Caminhos de arquivos no Windows ou quebras de linha precisam ser tratados com cuidado.

❌ Errado

{
  "caminho": "C:\Usuarios\Alice"
}

✅ Correto (Use barra dupla)

{
  "caminho": "C:\\\\Usuarios\\\\Alice"
}

---

5. Comentários no Arquivo

O formato JSON puro não suporta nenhum tipo de comentário (// ou / /). Se você precisa de documentação, use um campo de texto adicional como "_comentario": "texto".

Como evitar esses erros?

A melhor forma é usar um validador em tempo real. O Big JSON Viewer destaca erros de sintaxe instantaneamente, permitindo que você corrija o código antes mesmo de testar na sua aplicação.

Conclusão

Ficar atento a esses detalhes economiza horas de depuração. Sempre valide seus arquivos JSON antes de integrá-los e prefira gerá-los via código (usando JSON.stringify) em vez de escrevê-los manualmente.