10 errores de depuración JSON que roban horas (y cómo arreglarlos rápido)

La mayor parte del JSON averiado no es un caso excepcional: encaja en una lista muy corta de errores porque el formato de intercambio tiene gramática austera. Dejas de perderte apenas comparas muestras reales porque las apps de mensajería pueden reacomodar citas elegantes retirando escapes antes de llegar proceso productivo mismo.

Repasamos diez trampas que más horas han costado combinando parsers estrictamente RFC 8259 con referencias rápidas del estilo JSON.parse en MDN, y destacamos Safe Local Tools, que permite formatear e inspeccionar en tu navegador sin subir payloads sensibles.

Por qué "funciona en Node prototipo" pero falló parser despliegues

Desarrolladores confunden JSON intercambiado almacenamiento con literales objeto JS runtime tolerando comentarios trailing commas valores undefined ciertos serializers—entonces primera serialización escritura archivo descubre real problema.

Documentación navegadores como JSON.parse MDN muestra exactamente porque Unexpected token: es referencia rápida confiable cuando equipo discute si problema encoding o contenido sintáctico efectivo—así comparas el mensaje oficial con las estimaciones a ojo que circulan por el equipo.

Además problema social tooling: herramientas chat formateadores online reescritura carácter invisibles. Depuración seria conserva muestra bytes hashing comparas normalización local Safe Local Tools sin mover secretos servidor anónimos.

{
  "userId": 42,
  "role": "editor",
}

Comas fin después última pareja objeto arreglos

Comas pendientes válidas algunos transpilers modern JS pero ilegales JSON puro porque parser intercambiador encuentra coma sin siguiente valor termina errores algunos IDE no resaltan claramente dependiendo tema colores porque paréntesis objeto parecen balanceados suficientemente.

Las plantillas y generadores a veces emiten coma final porque el último campo cambió y el merge dejó coma colgante: elimina ese patrón con JSON.parse sobre fixtures automatizadas en CI, sobre todo cuando los archivos enormes obligan revisar sólo sintaxis resaltado sin leer todas líneas manualmente.

Safe Local Tools permite inspeccionar localmente porque secretos rutas IAM no debes arrastrarlo convertidor web desconocido sin revisión seguridad—incluso dentro de equipos que se conocen bien.

Comillas simple escapado control caracteres valores no JSON

Cadenas requieren comillas dobles interiores " escaped ". Comillas tipo tick 'status' inválidas aun modelo mental JS familiar. Nueva línea cruda dentro cadena igual prohibida—necesitas \n o base64 plan según modelo amenaza legibilidad humanos.

Valores como NaN Infinity undefined no existen espec JSON— serializers deben proyectarlos strings null omisiones conscientes porque observabilidad a veces emite intermittente NaN división métricas rompe ingestión exporters sin fallar tests unitarios porque ruta error rara ejecuta pocas noches saturación cargas weird.

const reparado = JSON.stringify({ status: "ok" });

Claves duplicadas comentarios estilo JSONC mezclas encodings BOM

Algunos cargadores YAML/JSON amalgaman interpretaciones duplicados último gana silencioso—consumidor decide primero encuentra comportamiento nondeterministic cross-language porque JSON orden conceptual no orden inserción garantizado externos.

Comentarios // muy útiles humanos ilegales RFC JSON estándares—rename .jsonc donde tooling lo permita ó pipeline build strip. BOM UTF‑8 inicial arruina parser posición columna cero error crípticos provenientes dumps Excel ERP viejos Windows.

Normaliza UTF‑8 sin BOM export interoperable web y valida muestras rápidamente localmente sin filtrajes credenciales hacia SaaS porque JSON debug incidencias contiene típicamente tokens OAuth accidentales—la inspección con Safe Local Tools en local en el navegador reduce superficie de fuga inadvertida.

Drift tipos porque API versionó campos inadvertidamente

Paradigma cliente userId número entonces string siguientes liberaciones ORM "útiles" coercionan strings porque colision formato proveedor—entonces rompes validaciones estrictas en Go o Rust mientras JS sigue aceptándolo porque flexibiliza comparaciones.

Solución contract tests esquema OpenAPI JSON Schema revisiones conscientes porque JSON sintácticamente válido semántico incorrecto igualmente nocivo horas madrugadora.

Recuerdo precisión grande enteros pérdida algunos stacks JS double IEEE—IDs financieros big integers cruzados lenguajes requieren strings explícitas politica documentadas.

Mega JSON prettified tráficos calientes dificultan diff reviews

No error sintaxis operacional igualmente trampa porque banda ancha y CPU parse inflan costes microservicios gateways. Reviewers skim PR missing stray coma introduce mitad porque diff masivo ilegible human ojo fatiga.

Minificar transport prettify sólo vistas humanas debugging porque human legibility production path distinto SLA.

Safe Local Tools formateador local permite alternar rápido vistas sin backends loggeando payloads sensibles porque permanece proceso cliente equipo.

Flujo método reducción binaria hasta schema confirma causa raíz

Captura bytes fallidos exactamente no sólo Slack reformateado porque Slack alteró escapados. Parser indica índices posición aprovecha halves eliminativos hasta reproducir snippet mínimo fallo.

Revalida usando serializer producción final porque problema doble stringify anidado algunas capas colas mensajes—they escapan string ya escaped generando escapes duplicados invisibles ojo rápido.

Golden fixtures positivos negativos (incluye intencionalmente trailing comma duplicados) CI bloque regressions porque JSON errores clasificaciones "solo humanos vigilantes" nunca escalable enterprise.

JSON aparece mundano porque ubiquitos pero riguroso porque diseñado interoperabilidad mínimos—mezclar hábitos lenguajes dinámicos termina ciclo errores triviales muy caros. Normaliza formato local sin servidores terceros con Safe Local Tools proceso navegador. Cuando payloads complejos esperan refactor seguro clic "Probar formateador JSON →" sanea indentación validaciones visuales manteniendo tus secretos equipo.