Cómo validar JSON online (y qué significa cada mensaje de error)
Valida JSON online y entiende el error: comas finales, comillas simples, claves sin comillas, comentarios, BOM, claves duplicadas y números largos, con su solución.
Actualizado el 8 de noviembre de 202610 min de lectura
Para validar JSON, pégalo en el validador JSON o suelta el archivo .json encima y pulsa Validar. Un JSON válido recibe un veredicto verde con su tipo raíz y su estructura. Un JSON inválido recibe un veredicto rojo y la lista de todos los errores a la vez, cada uno con su línea, su columna y un signo ^ bajo el carácter exacto. Lo difícil no suele ser descubrir que algo falla, sino entender el mensaje, porque cada programa lo redacta de otra manera. Esta guía explica qué significan los mensajes habituales, qué «errores» son en realidad otro dialecto de JSON, por qué un archivo perfecto falla en la posición 0 y cuáles son los dos problemas que pasan por cualquier parser sin hacer ruido.
Cómo validar JSON online, paso a paso
Pega el JSON o añade el archivo
Abre el validador JSON y pega el texto en el editor, o suelta un archivo. Acepta .json, .jsonc, .json5, .ndjson, .jsonl, .geojson, .webmanifest, .har, .map y .txt. Funciona tanto con JSON minificado como con JSON indentado.
Deja el tipo de documento en Automático
Automático lee el texto como un único documento JSON. Si parece tener un registro por línea, la herramienta te ofrece comprobarlo como NDJSON en lugar de cambiarlo por su cuenta.
Pulsa Validar
Si pasa, verás el tipo raíz (objeto, array, etc.), el número de claves o elementos y un informe de estructura: nodos, profundidad máxima, objetos, arrays, claves, líneas, tamaño y la codificación leída. Si falla, cada error aparece con Ln y columna; pulsa Ir para llevar el cursor hasta él.
Lee también las advertencias
Las claves duplicadas y los números que pierden precisión aparecen como advertencias. No cambian el veredicto, porque cualquier parser los acepta, pero es ahí donde los datos desaparecen sin avisar.
Corrige a mano o usa la copia reparada
Si los únicos problemas son comentarios, comas finales, comillas simples y similares, se ofrece una copia reparada en JSON estricto. Pulsa Usar el JSON reparado para cargarla en el editor, o Descargar .json reparado.
Qué significan de verdad los mensajes de error de JSON
Cada lenguaje y cada aplicación redacta a su manera el mismo puñado de fallos, y la posición que indica es donde el parser se rindió, que suele estar un carácter después de tu error. Esta tabla traduce los mensajes típicos en inglés que encontrarás en otros sitios a su causa y al mensaje que muestra el validador.
| Mensaje típico en otros programas | Lo que suele significar | Lo que dice el validador |
|---|---|---|
| «Expected double-quoted property name» o «Expecting property name enclosed in double quotes» | Una coma final antes de }, una clave con comillas simples o sin comillas | Una coma final antes del cierre; o bien: la clave no está entrecomillada |
| «Unexpected token» o «Expecting value» | Algo que no es un valor JSON: un comentario, NaN, undefined, True o un carácter suelto | JSON no admite comentarios; o bien: no es un valor JSON |
| «Expecting ',' delimiter» | Dos miembros o elementos sin una coma entre ellos | Falta una coma antes de este valor |
| «Unexpected end of JSON input» | Una llave o un corchete que nunca se cierra, o un texto cortado | Se abre un objeto (o un array) y nunca se cierra |
| «Unterminated string» o «Bad control character in string literal» | Falta la comilla de cierre, o hay un salto de línea o un tabulador real dentro de una cadena | Esta cadena nunca se cierra; o bien: un carácter de control hay que escaparlo |
| «Unexpected non-whitespace character after JSON» o «Extra data» | Dos documentos pegados juntos, o un registro por línea | El valor JSON termina antes de esto; todo lo que sigue sobra |
| «Unexpected token» en la posición 0 o «Unexpected UTF-8 BOM» | Bytes invisibles antes de la primera llave, o un archivo que no es JSON | Se quita la marca y se indica la codificación |
La «posición» de esos mensajes cuenta caracteres desde cero: la posición 0 es el primer carácter y la posición 7 es el octavo. Las líneas y columnas cuentan desde uno. El validador te da todos estos datos, más un desplazamiento en bytes para scripts, y los calcula él mismo, así que la ubicación es la misma uses el navegador que uses.
Todos los errores a la vez con línea, columna y marca, además de claves duplicadas, avisos de precisión, JSON Schema y reparación. Gratis: texto pegado o un archivo de hasta 25 MB, con todas las comprobaciones incluidas. Pro: hasta 100 archivos de una vez e informes legibles por máquina en JSON y CSV. Todo se ejecuta en tu dispositivo, no en nuestros servidores.
Validar JSONComas finales, comillas simples, claves sin comillas, comentarios: ¿roto o un dialecto?
Muchos archivos que aparecen como JSON inválido no están dañados en absoluto. Están escritos en un dialecto más permisivo que tu editor lee sin problemas y que un parser estricto rechaza. Saber cuál es te dice si hay que corregir el archivo o el programa que lo lee.
- JSONC (JSON con comentarios) añade comentarios con // y /* */ y comas finales. tsconfig.json, .eslintrc y la mayoría de archivos de ajustes de los editores son JSONC. Funcionan en el editor y fallan en un proceso que espera JSON puro.
- JSON5 permite además claves sin comillas, cadenas con comillas simples, números hexadecimales, un signo más o un punto decimal al principio, y NaN e Infinity.
- Un diccionario de Python impreso por un script parece JSON, pero usa True, False y None, y a menudo comillas simples.
- El texto copiado de un procesador de textos puede traer comillas tipográficas (“ ”) en lugar de comillas rectas. Parecen correctas y no son JSON.
Cuando el texto es uno de estos casos, el validador lo dice con claridad (por ejemplo, que es JSONC y no JSON roto) y enumera las construcciones responsables. La reparación parte de lo que encontró el analizador, así que nunca toca un // dentro de una URL ni una coma dentro de un valor entrecomillado. NaN e Infinity no tienen escritura en JSON y pasan a null, y ese cambio se señala. Si además del dialecto quedan errores de sintaxis reales, no se ofrece copia reparada. Para dejar el resultado con una indentación legible, consulta cómo formatear JSON online.
Por qué un archivo perfecto falla en la posición 0: BOM y UTF-16
Si un error señala la posición 0, línea 1, columna 1, y el archivo parece correcto, sospecha de los bytes que no se ven. Una marca de orden de bytes UTF-8 (BOM) son tres bytes, EF BB BF, que algunas herramientas de Windows escriben delante del texto, entre ellas Out-File de PowerShell, StreamWriter de .NET y la exportación UTF-8 de Excel. Un parser estricto ve un carácter inesperado antes de la llave de apertura y rechaza un documento que, por lo demás, está bien.
UTF-16 es peor: Windows PowerShell lo escribe cuando no se indica codificación y, leído como UTF-8, parece un byte NUL después de cada carácter. El validador detecta ambos casos, valida el documento como si la marca no existiera e indica la codificación usada en el informe de estructura. Para que otros programas lo lean, guarda el archivo de nuevo como UTF-8 sin BOM; en PowerShell, indica una codificación explícita al comando que lo escribe. Un archivo que ni siquiera es texto, como una imagen renombrada a .json, se rechaza con ese motivo en vez de con un error de sintaxis confuso.
Válido pero incorrecto: claves duplicadas y números largos
Hay dos problemas que no provocan ningún error en ningún parser, y por eso llegan a producción. El primero es una clave duplicada. JSON permite la misma clave dos veces en un objeto, y lo habitual es quedarse con el último valor y descartar el primero sin decir nada: {"a": 1, "a": 2} se convierte en silencio en {"a": 2}. El validador informa de cada repetición dentro de un objeto con un JSON Pointer que lleva hasta ella, como /users/3/email. La misma clave en dos objetos distintos es normal y no se señala.
El segundo es un número demasiado largo para guardarse con exactitud. La mayoría de parsers leen los números JSON como coma flotante de 64 bits, que solo representa enteros exactos hasta 9.007.199.254.740.991. 12345678901234567890 vuelve como 12345678901234567000, sin ningún error. Los ID de bases de datos, los números de pedido y los decimales largos son las víctimas típicas. El validador muestra el literal exacto junto al valor que producirá un parser; 1e400, que se desborda a Infinity, también se marca. La solución está en el lado que envía: manda esos valores como cadenas. Ambas comprobaciones están activadas por defecto en Comprobaciones extra y se pueden desactivar.
Comprobar la forma con un JSON Schema
Una sintaxis válida solo significa que el texto se puede analizar. Si tiene los campos que espera un programa es otra cuestión, y la responde un JSON Schema. Pega un esquema en el cuadro JSON Schema de los ajustes y el documento se comprobará también contra él después de la sintaxis. Se admiten el draft 2020-12 y el draft-07; el draft se lee de $schema o, si el esquema no lo declara, se supone y se indica. Cada fallo llega con un JSON Pointer y su línea, con mensajes como «Falta la propiedad obligatoria id» o «Se esperaba string y se encontró number».
Hay dos detalles que sorprenden. Un $ref que apunta a otro servidor se señala pero no se descarga, para que tu esquema no salga de tu dispositivo; incluye las definiciones en el propio esquema. Y "format": "email" es una nota, no una regla, tal como lo definen ambos drafts, así que una dirección incorrecta pasa a menos que marques Tratar format como regla, no como nota. El documento tiene que analizarse primero; un JSON con errores de sintaxis no se compara con el esquema.
Archivos de log y un registro por línea
Los logs, las exportaciones de datos y las peticiones masivas a una API suelen ser NDJSON o JSON Lines: un valor JSON por línea. Leído como un solo documento, un archivo así falla con un único error inútil sobre contenido de más al principio de la línea 2. Cambia Tipo de documento a NDJSON (o acepta la sugerencia) y cada línea se comprueba como un registro propio, con el número de registro junto a la línea y la columna de cada fallo. El salto de línea final no cuenta como registro, los finales de línea de Windows se gestionan y una línea en blanco en medio se señala, porque el formato no tiene registros vacíos. La validación con esquema se aplica a un único documento, así que no está disponible en el modo NDJSON.
Límites gratis y Pro
| Gratis | Pro | |
|---|---|---|
| Entrada | Texto pegado o un archivo cada vez | Hasta 100 archivos de una vez |
| Tamaño | Hasta 25 MB | Limitado por tu dispositivo |
| Comprobaciones | Todos los errores, advertencias, JSON Schema, NDJSON, reparación | Las mismas |
| Informe | Informe de texto para copiar o descargar | También informes JSON y CSV, y un ZIP para un lote |
Todo lo que decide si un documento es válido es gratis. Si un archivo supera el límite y solo necesitas una parte, el visor JSON te permite recorrer la estructura. Si tus datos eran YAML o CSV, conviértelos antes con YAML a JSON o CSV a JSON. Si cada comilla lleva una barra invertida delante, el JSON se guardó dentro de una cadena; quítale el escape y luego valídalo.
Preguntas frecuentes
¿Cómo compruebo si un archivo JSON es válido?
Pega el texto o suelta el archivo en el validador JSON y pulsa Validar. Un «JSON válido» en verde significa que cumple el estándar JSON (RFC 8259); un «JSON inválido» en rojo enumera cada error con su línea y columna.
¿Por qué mi JSON dice «unexpected token» en la posición 0?
Normalmente el archivo empieza con una BOM UTF-8 o está guardado en UTF-16, así que el parser encuentra un carácter invisible antes de la primera llave. Guárdalo como UTF-8 sin BOM. Con menos frecuencia, el archivo ni siquiera es JSON, por ejemplo una página de error HTML guardada como .json.
¿Se permiten comas finales en JSON?
No. El JSON estándar no permite una coma antes de } o ]. JSONC y JSON5 sí, y por eso el mismo archivo funciona en un editor y falla en otro sitio. Quita la coma o usa la copia reparada que ofrece el validador.
¿Puede JSON tener comentarios?
No en JSON estándar. Los archivos con comentarios // o /* */ son JSONC. El validador nombra el dialecto y puede darte una copia estricta sin los comentarios; un // dentro de una cadena, como una URL, queda intacto.
¿Por qué mi JSON es válido pero faltan datos?
Revisa las advertencias. Una clave que aparece dos veces en un objeto solo conserva su último valor, y un número mayor que 9.007.199.254.740.991 se redondea al analizarlo. Ninguno de los dos provoca un error, y el validador informa de ambos.
¿Es seguro validar aquí un JSON privado?
Sí. La comprobación se ejecuta en tu dispositivo, no en nuestros servidores, así que las respuestas de API, los tokens y los archivos de configuración no se suben. Una vez cargada la página, sigue funcionando sin conexión a la red.