Cómo corregir JSON no válido

Un mensaje como «Unexpected token» casi nunca explica qué está mal. Esta guía resume las reglas de JSON que importan, cómo encontrar el punto exacto de un error y cómo corregir los fallos que provocan la mayoría del JSON no válido.

Abrir la herramienta: Formateador JSON

Las reglas que más fallan

  • Los textos y las claves solo usan comillas dobles: "nombre", nunca 'nombre'.
  • Cada clave es un texto entre comillas. {nombre: 1} es JavaScript válido, pero no JSON.
  • No va coma después del último elemento de un objeto o un array.
  • No se permite ningún tipo de comentario.
  • Los únicos valores literales son true, false y null, siempre en minúsculas.
  • Los números no llevan ceros a la izquierda, ni signo más, ni formato hexadecimal. NaN e Infinity no están permitidos.

Encuentra la posición exacta del error

Los parsers indican la posición en la que se detuvieron, que suele estar justo después del error real. Si el error señala una llave de cierre, mira la línea anterior: lo típico es una coma final o una comilla que falta.

Nuestro formateador muestra la línea y la columna, cita la línea con una marca bajo el problema y tiene un botón Mostrar en la entrada que selecciona el carácter exacto, algo muy útil en el móvil.

Errores que vienen de copiar y pegar

El JSON copiado de un procesador de textos, una app de chat o un correo suele traer comillas tipográficas (“ ”) en lugar de rectas (") o espacios de no separación invisibles. Parecen correctos, pero no son válidos. Reparar JSON los sustituye.

Los datos copiados de la salida de Python usan True, False y None, y comillas simples. Los copiados de código JavaScript pueden tener claves sin comillas y comentarios. Reparar JSON lo convierte todo en JSON estándar.

Cuando el JSON está cortado

Si una línea de log o la salida de la terminal se truncó, el error dice que el JSON termina antes de tiempo. Ninguna herramienta puede adivinar con seguridad la parte que falta. Copia de nuevo la respuesta completa, o guárdala en un archivo y abre ese archivo.

Comprueba la corrección

Después de editar, la línea de estado se pone verde y muestra cuántas claves y niveles de anidación tiene el documento. Cambia a la vista de árbol para confirmar que la estructura es la esperada antes de usar el JSON en tu código o configuración.