Cómo validar un JSON y localizar el error

Respuesta breve

Validar un JSON no consiste en corregir todo el documento de una vez. El método más fiable es encontrar el primer punto donde el analizador ya no puede continuar, revisar qué hay alrededor, hacer un único cambio y repetir la comprobación.

Esta guía explica ese proceso con ejemplos que puedes reproducir en el validador JSON de Tools in a Tab. La herramienta no modifica la entrada: señala el tipo de problema, su ubicación y el contexto para que tú decidas la corrección.

Respuesta rápida: corrige un error cada vez

1. Pega o escribe el documento en el validador.
2. Pulsa Validar JSON o utiliza Ctrl/⌘ + Intro.
3. Lee el tipo de error, la línea, la columna y el fragmento de contexto.
4. Usa Ir al error y revisa también los caracteres inmediatamente anteriores al indicador.
5. Cambia solo la causa que has identificado.
6. Valida de nuevo. Si había más problemas, aparecerá el siguiente.

Este orden importa. Formatear o aplicar sustituciones masivas antes de comprender el error puede cambiar datos correctos y ocultar la causa original.

Ejemplo completo: localizar una coma final

Este documento representa el estado de un pedido, pero tiene una coma que no debería estar ahí:

{
  "pedido": 1842,
  "estado": "enviado",
}

Al comprobarlo, el validador muestra Coma final, línea 3, columna 22. El contexto coloca el indicador debajo de la coma posterior a "enviado":

  "estado": "enviado",
                     ^

La línea y la columna permiten llegar a la zona exacta. El tipo de error explica qué regla se incumple: JSON no admite una coma justo antes de cerrar un objeto con } ni un array con ].

Elimina únicamente esa coma:

{
  "pedido": 1842,
  "estado": "enviado"
}

Al volver a validar, el resultado pasa a JSON válido. El documento conserva los mismos datos; solo se ha retirado el carácter que rompía la sintaxis.

Qué significan la línea, la columna y el contexto

La línea y la columna empiezan a contar desde 1. Juntas describen una posición del texto, mientras que el contexto enseña esa línea y coloca un indicador bajo el carácter detectado.

Esa posición no siempre es la causa exacta. Un analizador avanza mientras la entrada puede formar un documento válido y se detiene al encontrar algo que ya no encaja. A veces señala el carácter posterior al que falta o sobra.

Por ejemplo, aquí falta una coma al final de la línea 2:

{
  "pedido": 1842
  "estado": "enviado"
}

El analizador llega al comienzo de "estado", en la línea 3, columna 3, y descubre que no puede iniciar otra propiedad. Aunque el indicador aparece en la tercera línea, la corrección está justo antes: añadir una coma después de 1842.

{
  "pedido": 1842,
  "estado": "enviado"
}

Por eso conviene revisar el carácter señalado y el final de la línea anterior antes de realizar cambios más amplios.

Dos diagnósticos que exigen mirar alrededor

Los siguientes casos son breves a propósito. Sirven para practicar la lectura del diagnóstico, no para reunir todos los errores posibles de JSON.

Propiedades y cadenas con comillas simples

{'entorno': 'producción', 'activo': true}

JSON utiliza comillas dobles para los nombres de propiedades y para las cadenas. No basta con que el texto se parezca a un objeto de JavaScript. La versión válida es:

{ "entorno": "producción", "activo": true }

No sustituyas todas las comillas de forma automática si el contenido puede incluir apóstrofos: revisa qué caracteres delimitan realmente cada cadena.

Una comilla interior sin escapar

{"mensaje": "Dijo "hola""}

La comilla anterior a hola cierra la cadena antes de tiempo. El analizador encuentra después otra palabra donde esperaba un separador y puede describir el síntoma como una coma ausente. Mirar los caracteres anteriores revela la causa.

Las comillas que forman parte del texto deben escaparse con una barra inversa:

{ "mensaje": "Dijo \"hola\"" }

Este ejemplo muestra por qué un diagnóstico es un punto de partida y no una corrección automática infalible.

Repite la validación hasta completar el documento

Los analizadores suelen informar del primer error detectable. Si un documento tiene una coma final y, más adelante, una cadena sin cerrar, el segundo problema puede permanecer oculto hasta corregir el primero.

Después de cada cambio:

1. Vuelve a validar la entrada completa.
2. Confirma si ya aparece JSON válido.
3. Si surge otro diagnóstico, repite el mismo proceso desde su nueva ubicación.

Corregir de uno en uno hace que cada cambio sea pequeño, comprobable y fácil de deshacer.

JSON válido no significa datos correctos para una API

La validación sintáctica comprueba que el texto cumple la gramática de JSON: objetos, arrays, propiedades, valores, comillas, separadores y escapes. No conoce las reglas del sistema que recibirá esos datos.

Este documento es JSON válido:

{
  "pedido": 1842,
  "estado": "desconocido"
}

Una API aún podría rechazarlo si solo admite "pendiente", "enviado" o "entregado". Las propiedades obligatorias, los tipos esperados, los formatos de fecha y otras reglas de negocio deben comprobarse con la documentación de la API o con un JSON Schema específico.

Qué hacer cuando el JSON ya es válido

Si necesitas hacerlo más legible o compacto, utiliza el formateador JSON después de validar. El formateador cambia espacios y saltos de línea, mientras que el validador conserva la entrada y se centra en explicar el primer problema.

Si el documento se enviará a otra aplicación, comprueba a continuación sus reglas específicas. La sintaxis válida es el primer filtro, no la aprobación final de los datos.

Privacidad al revisar un JSON

El validador y el formateador de Tools in a Tab procesan el contenido dentro de la pestaña. La entrada no se envía a nuestros servidores, no se añade a la URL y no se guarda en almacenamiento local.

Aunque el proceso sea local, revisa si el documento contiene contraseñas, tokens u otros secretos antes de copiarlo a cualquier aplicación o compartir un diagnóstico con otra persona.

Preguntas frecuentes

¿Por qué la ubicación parece estar después del error?

Porque el analizador indica el primer punto donde ya no puede continuar. Si falta una coma o una comilla se cerró antes de tiempo, la causa puede estar justo antes de la posición mostrada.

¿Por qué aparece otro error después de corregir el primero?

Porque un error anterior puede impedir que se analice el resto del documento. Corrige un problema, vuelve a validar y repite hasta obtener un resultado válido.

¿Un JSON válido garantiza que una API lo acepte?

No. Solo confirma la sintaxis. La API puede exigir propiedades, tipos, valores o formatos adicionales que deben revisarse en su documentación o esquema.

Referencia técnica

Para consultar más patrones concretos —comentarios, escapes, números, cierres y contenido adicional— revisa errores comunes al escribir JSON.

La sintaxis interoperable de JSON está definida en RFC 8259. La guía utiliza esa gramática y comprueba sus ejemplos contra el validador publicado de Tools in a Tab.