BLOG · Herramientas
Cómo validar y formatear JSON: errores, límites y qué puede cambiar
Guía de errores y límites de JSON: qué puede cambiar un formateador, cómo leer mensajes de error y cómo validar JSON en PHP.
Actualizado: 2026-10-14
JSON representa datos mediante objetos, arreglos y valores, y lo encontrarás en respuestas de APIs, configuraciones e intercambios entre aplicaciones. Esta guía no repite lo básico: está pensada para cuando ya sabes qué es JSON y necesitas entender por qué falla, qué cambia un formateador y cómo depurar datos reales.
Si buscas una explicación de la sintaxis y un ejemplo rápido, empieza por nuestro formateador JSON y vuelve aquí para los casos difíciles.
Validar no es lo mismo que formatear
Validar comprueba que el texto cumple la sintaxis de JSON. Formatear lo reescribe con sangría y saltos de línea para que sea legible. Una herramienta que hace ambas cosas suele hacerlo en dos pasos: interpreta el texto y luego lo vuelve a escribir. Ese segundo paso es donde pueden aparecer cambios que no esperabas.
Qué puede cambiar al volver a escribir el JSON
Cuando un formateador interpreta el texto y lo regenera (lo habitual con JSON.parse y JSON.stringify en JavaScript), conviene conocer estos casos:
- Números muy grandes: JavaScript guarda los números como decimales de doble precisión y solo representa enteros exactos hasta 9007199254740991. Un identificador como
12345678901234567890puede salir como12345678901234567000. Si tus IDs son largos, trátalos como texto ("12345678901234567890"). - Representación numérica:
1.0puede volver como1y1e2como100. El valor es equivalente, pero el texto ya no es idéntico. - Claves repetidas:
{"a":1,"a":2}es aceptado por muchos analizadores, que se quedan con el último valor. Al regenerar el texto, el primero desaparece sin aviso. - Orden de las claves: en JavaScript, las claves que parecen enteros (
"1","2") se ordenan antes que las demás. Un objeto con"b"y"1"puede cambiar de orden. - Secuencias de escape:
"\u00e9"puede convertirse en"é". Es el mismo texto, pero distinto a nivel de bytes.
Si el JSON es un contrato firmado, una configuración que se compara con un hash o un archivo que debe quedar idéntico, no lo reemplaces con la salida del formateador sin compararlo antes.
Cómo leer un mensaje de error
Los mensajes varían según el navegador o el lenguaje, pero casi siempre indican una posición (carácter, línea o columna). Dos reglas ayudan:
- El error suele aparecer donde el analizador se dio cuenta, que puede ser un poco después de donde está el problema real. Revisa el elemento anterior a la posición indicada.
- "Unexpected end of JSON input" significa que el texto terminó antes de tiempo: falta cerrar una llave, un corchete o unas comillas, o la entrada está vacía.
Errores que no parecen errores
- Una página HTML en lugar de JSON: si el mensaje habla de un token inesperado
<en la posición 0, lo que recibiste no es JSON sino una página HTML, casi siempre un error del servidor o una redirección a un login. Revisa el código de estado y el encabezadoContent-Type. Si el servidor es PHP, esta guía sobre el error 500 en PHP te ayuda a investigar el origen. - Un carácter invisible al inicio: algunos editores guardan archivos UTF-8 con BOM, un carácter invisible que hace fallar a ciertos analizadores. Si el error apunta a la posición 0 y no ves nada raro, guarda el archivo como "UTF-8 sin BOM".
- Valores de otros lenguajes:
True,None(Python),NaN,Infinityyundefinedno son JSON válido. JSON solo admitetrue,falseynull. - Ceros a la izquierda y hexadecimales:
007y0xFFno son números válidos en JSON. - Copiar desde un documento: al pegar desde Word o un chat, las comillas dobles pueden convertirse en comillas tipográficas (“ ”), que JSON no reconoce.
Válido no significa correcto
Pasar la validación solo demuestra que la sintaxis es aceptable. No garantiza que una API acepte tus campos. Un valor "100" (texto) y 100 (número) son ambos JSON válido, pero una aplicación puede rechazar uno de ellos. Para comprobar nombres, tipos y campos obligatorios existe JSON Schema, un estándar que describe la estructura esperada y permite validarla de forma automática.
Validar JSON en PHP
En PHP, json_decode devuelve null cuando el texto no es válido, pero null también es un JSON válido. Para distinguirlos, usa la bandera de excepciones:
try {
$datos = json_decode($texto, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
echo 'JSON inválido: ' . $e->getMessage();
}Si trabajas con versiones antiguas, consulta json_last_error_msg() después de decodificar. Para generar JSON legible, json_encode acepta JSON_PRETTY_PRINT, y JSON_UNESCAPED_UNICODE evita que los acentos salgan como \u00e9.
Buenas prácticas de privacidad
La herramienta de RunnerSoft procesa el texto en tu navegador, pero eso no justifica pegar secretos en cualquier servicio de internet. Antes de compartir una respuesta de API, elimina tokens, contraseñas y datos personales, o sustitúyelos por valores ficticios.
