Cómo validar y formatear JSON sin errores

Las seis reglas: por qué JSON no perdona

JSON tiene seis reglas sintácticas y no perdona ninguna. Primera: las claves y los textos van siempre entre comillas dobles —"nombre", nunca 'nombre'—. Segunda: no se admiten comas finales tras el último elemento de un objeto o array. Tercera: no se admiten comentarios de ningún tipo.

Cuarta: los valores solo pueden ser texto, número, booleano (true/false), nulo (null), objeto o array. Quinta: los números no llevan comillas —"edad": 30, no "edad": "30"— y usan punto decimal, nunca coma. Sexta: cada llave y corchete que se abre debe cerrarse.

Un JSON válido mínimo: {"nombre": "Ana", "edad": 30, "activo": true, "tags": ["dev", "es"]}. Parece obvio, pero la mayoría de los errores reales son violaciones de estas seis reglas en documentos de cientos de líneas donde el ojo humano no llega.

Paso 1: Valida y aprende a leer los errores

El flujo profesional empieza pegando tu JSON en la herramienta gratuita de validar JSON de Tótem (usatotem.com/herramientas-desarrollador/validar-json/). Si el documento es válido, lo sabrás al instante; si no, el validador te dirá exactamente dónde está el problema: línea, columna y descripción del error.

Aprende a leer los mensajes de error, que siguen patrones predecibles. «Unexpected token }» suele significar una coma de más antes de esa llave. «Unexpected end of input» indica llaves o corchetes sin cerrar: cuenta aperturas y cierres. «Unexpected token '» delata comillas simples donde tocan dobles.

La técnica de diagnóstico es sistemática: ve al punto exacto que indica el error y mira justo antes —el problema casi siempre está en el carácter anterior al señalado—. Corrige, vuelve a validar y repite. Con documentos grandes, este ciclo de validar-corregir es infinitamente más rápido que revisar a ojo.

Paso 2: Formatea para ver la estructura

Un JSON válido pero minificado —todo en una línea— es ilegible para humanos. Formatear significa aplicar sangría y saltos de línea para revelar la estructura: cada nivel de anidamiento con su indentación, cada elemento en su línea. El validador de Tótem formatea automáticamente al validar.

El formateo no es estética: es herramienta de depuración. Un objeto mal anidado se ve a simple vista cuando la indentación lo delata; en una línea minificada es invisible. Antes de buscar un error lógico en tu código, formatea el JSON y míralo con calma: la mitad de las veces el problema salta a la vista.

Adopta una convención de sangría —2 espacios es lo más común— y mantenla en tus archivos de configuración. Y recuerda: el formateo no cambia el contenido, solo su presentación. Un JSON formateado y uno minificado son idénticos para cualquier programa; la diferencia es solo para tus ojos.

Los 5 errores que causan el 90 % de los problemas

Memoriza estos cinco y diagnosticarás el 90 % de los JSON rotos. Primero, la coma final: {"a": 1,} —inválida en JSON aunque JavaScript la permita—. Es el error número uno, traicionero porque «casi» se ve bien.

Segundo, comillas simples: {'a': 1} —JSON exige dobles—. Típico al copiar código JavaScript. Tercero, comentarios: {"a": 1 // comentario} —JSON no los admite; si necesitas documentar, usa una clave "_comentario".

Cuarto, llaves sin cerrar en documentos largos: un objeto anidado al que le falta su } final. El error «unexpected end of input» es su firma. Quinto, texto sin comillas en valores: {"estado": activo} —«activo» debe ir entre comillas—. Cada uno tiene un mensaje de error característico: aprende a reconocerlos y los corregirás en segundos.

Más allá de la sintaxis: validar los datos

Cuando el JSON es válido pero los datos no cuadran —un campo que debería ser número llega como texto, una fecha en formato inesperado—, el problema ya no es de sintaxis sino de contrato. Aquí ayudan dos prácticas: inspeccionar la estructura formateada nivel por nivel, y comparar la respuesta real con la documentada.

Para APIs, valida también los tipos: {"precio": "19.99"} es sintácticamente válido pero probablemente incorrecto si el consumidor espera un número. Estos errores no los detecta el validador de sintaxis; los detectas tú revisando el documento formateado con ojo crítico.

Y un consejo final de higiene: nunca construyas JSON concatenando textos a mano en tu código —es la fábrica de los errores de este tutorial—. Usa las funciones de serialización de tu lenguaje (JSON.stringify, json.dumps, json_encode): generan JSON válido siempre, con el escapado correcto de comillas y caracteres especiales. Validar es para depurar; generar bien es para no tener que depurar.

Preguntas frecuentes

En resumen

Validar y formatear JSON se reduce a un hábito: pega tu JSON en el validador antes de usarlo, lee el mensaje de error con calma —casi siempre es una coma, una comilla o una llave—, corrige y formatea para trabajar con claridad. Con los cinco errores típicos memorizados, diagnosticarás un JSON roto en segundos.

Haz del validador gratuito tu primera parada cada vez que un JSON falle: te dirá exactamente dónde está el problema y te devolverá el documento formateado y listo para usar.

• Cómo codificar y decodificar en Base64 Tutorial
• Cómo crear expresiones regulares sin volverte loco Tutorial
• Cómo generar un hash SHA-256 y para qué sirve Tutorial
• Cómo generar una contraseña segura paso a paso Tutorial