Saltar al contenido
FrAIFlow

Soluciones

Por qué un JSON aparentemente válido falla en el primer carácter

Puede ver un objeto JSON válido y, aun así, recibir un error en la posición cero. La llave de apertura quizá no sea el primer carácter: puede haber un U+FEFF invisible delante. Conserve el original antes de intentar repararlo. Una página HTML de inicio de sesión, una respuesta vacía o un archivo mal decodificado requieren otra solución.

En una consulta de Stack Overflow de 2017 se rastreó un fallo similar en Node.js hasta el valor decimal 65279, es decir, U+FEFF. Una prueba local de navegador guardada aporta evidencia independiente: un U+FEFF sintético seguido de {"ok":true} falló y pudo analizarse después de quitar únicamente el prefijo. La captura registra esa prueba local, no el archivo de la persona que planteó la consulta.

Una reparación acotada que puede ejecutar

Empiece con una copia del archivo, no con su única exportación. Si procede de una petición web, compruebe primero el estado HTTP y el tipo de contenido: una página de inicio de sesión que empiece por <!doctype html> requiere corregir la autenticación, no limpiar el JSON. Para un archivo local, utilice un editor que muestre la codificación. No sobrescriba el original mientras investiga.

Una vez decodificado el archivo en una cadena de JavaScript llamada text, utilice la siguiente función en su script de importación. Admite un único marcador inicial conocido y no modifica nada más.

function parseJsonText(text) {
  if (typeof text !== "string") throw new TypeError("Expected text");
  const hadBOM = text.charCodeAt(0) === 0xFEFF;
  const cleaned = hadBOM ? text.slice(1) : text;
  return { value: JSON.parse(cleaned), removedLeadingBOM: hadBOM };
}
const sample = '\uFEFF{"ok":true,"name":"한글"}';
const result = parseJsonText(sample);
console.log(result.removedLeadingBOM); // true
console.log(result.value.ok);          // true
console.log(result.value.name);        // 한글

La comprobación no termina cuando «desaparece el error». Verifique que existen las propiedades esperadas y que el texto no inglés sigue leyéndose correctamente. Pruebe también con JSON normal: debe analizarse sin indicar que se ha quitado un marcador. Una entrada vacía o un objeto mal formado deben seguir lanzando un error. Hágalo visible al código que llama a la función, en lugar de devolver un objeto vacío que pueda confundirse con datos válidos.

Si el primer punto de código no es U+FEFF, no continúe por esta vía. Por ejemplo, un archivo leído con la codificación incorrecta puede contener caracteres de sustitución o caracteres nulos alternados. Ábralo con la codificación utilizada por el exportador o solicite otra exportación en UTF-8. Borrar caracteres no permite reconstruir bytes que se han interpretado mal.

La diferencia entre los bytes y un carácter oculto

Prefijo oculto / U+FEFF  {"ok":true} / JSON.parse → rechazado
Explicación elaborada por el autor, no una captura de una aplicación.

TextDecoder("utf-8") normalmente omite un BOM UTF-8 inicial. Su opción ignoreBOM resulta poco intuitiva: true incluye el marcador en la cadena decodificada. Nuestro ejemplo de bytes EF BB BF 7B 7D se convirtió en {} con el comportamiento predeterminado. Esto no equivale a detectar automáticamente la codificación.

Revise el programa que genera el archivo

Otra consulta sobre PowerShell implicaba una ruta de decodificación incorrecta. Out-File y la redirección de Windows PowerShell pueden generar UTF-16LE; el comportamiento de versiones más recientes de PowerShell es distinto. Eliminar texto no ASCII puede destruir nombres válidos sin resolver esa incompatibilidad. Compruebe el comando y la versión que generaron el archivo y decodifique o exporte de nuevo correctamente. Nuestra prueba no reprodujo el proceso de aquella persona.

RFC 8259 exige UTF-8 para el JSON intercambiado fuera de un entorno cerrado y prohíbe añadir un BOM al JSON transmitido por red. Corrija el exportador si es posible. En el punto de importación, pruebe JSON normal, el prefijo confirmado, JSON mal formado y valores no ingleses. Registre únicamente el prefijo de diagnóstico, no el contenido privado de los documentos.

Los bytes EF BB BF pueden convertirse en U+FEFF; quitar solo ese prefijo permite analizar el JSON del ejemplo.
Ilustración explicativa en inglés. Los bytes EF BB BF pueden convertirse en U+FEFF; quitar solo ese prefijo permite analizar el JSON del ejemplo.
El test local muestra el error con U+FEFF inicial y el resultado ok: true después de retirar únicamente el prefijo.
El test local muestra el error con U+FEFF inicial y el resultado ok: true después de retirar únicamente el prefijo. Resultado del ejemplo sintético, no una captura de la aplicación del usuario. Abra la imagen para verla ampliada.
Fuentes, ejemplos y lecturas relacionadas