Los 6 errores más comunes de importación CSV y cómo arreglarlos
Todo data engineer ha perdido horas depurando importaciones CSV. Aquí los seis errores que vemos más a menudo, por qué ocurren y la forma más rápida de arreglar cada uno.
Error 1: Caracteres confusos (mismatch de codificación)
Síntoma: secuencias confusas como é en vez de caracteres legibles. Causa: archivo guardado en Windows-1252, abierto como UTF-8. Arreglo: re-decodificar con la codificación correcta, o usar la auto-detección de CSV First Aid.
Error 2: Primer encabezado empieza con basura (BOM)
Síntoma: el encabezado es '\ufeffid' en vez de 'id'. Los lookups fallan. Causa: BOM UTF-8 del 'Guardar como CSV UTF-8' de Excel. Arreglo: quitar el prefijo de 3 bytes.
Error 3: Datos en una columna (delimitador equivocado)
Síntoma: la fila entera aparece en una sola celda. Causa: el archivo usa punto y coma/tabs pero el parser espera comas. Arreglo: detectar el delimitador real y re-exportar.
Error 4: Columnas desplazadas (comillas rotas)
Síntoma: los datos aparecen en columnas equivocadas a partir de cierta fila. Causa: comilla sin cerrar o sin escapar. Arreglo: reparar el quoting según RFC 4180.
Error 5: 'Expected N columns, got M' (recuento inconsistente)
Síntoma: el importador rechaza el archivo o trunca filas. Causa: algunas filas tienen campos extra o faltantes. Arreglo: rellenar las cortas y marcar las largas.
Error 6: Filas en blanco fantasma o registros NULL extra
Síntoma: la base de datos tiene filas vacías, el recuento está inflado. Causa: saltos de línea finales, líneas en blanco entre bloques. Arreglo: quitar filas vacías.
Arreglar los 6 de una vez
CSV First Aid auto-diagnostica todos estos problemas y más (14 tipos en total). Suelta el archivo, revisa la diagnosis, aplica los fixes que quieras y descarga un CSV limpio. Gratis, sin registro, solo navegador.
¿Archivo con varios a la vez? CSV First Aid corre las seis comprobaciones en una sola pasada.
Arregla tu CSV ahora →Herramientas relacionadas
Arreglar la codificación CSV
¿Ves é, ü, ö donde esperabas é, ü, ö? El archivo se guardó en una codificación y se leyó en otra. Descubrimos cuál era y convertimos a UTF-8 — Müller vuelve a verse como Müller.
Eliminar el BOM UTF-8 de tu CSV
¿La primera columna aparece como 'ID' en vez de 'ID'? Eso es un BOM UTF-8 — tres bytes invisibles que muchos exportadores dejan. Los quitamos y el encabezado se lee limpio.
Reparar comillas CSV
Una comilla de cierre que falta convierte un campo único en un monstruo multilinea y desplaza cada columna siguiente. Encontramos las sin cerrar, las cerramos y re-escapamos las internas — según RFC 4180.
Arreglador de delimitador CSV
Los exports europeos usan punto y coma. Los volcados de BBDD usan tabs o pipes. Tu import espera comas. Husmeamos qué usa realmente el archivo y lo reescribimos a lo que tu tool quiere — coma, punto y coma, tab o pipe.
Arreglar recuentos de columnas CSV inconsistentes
El encabezado dice 5 columnas, algunas filas tienen 4, una tiene 7 — y tu importador se rinde. Rellenamos las cortas, marcamos las largas y te decimos exactamente qué números de línea revisar.
Eliminar filas vacías de un CSV
Las filas en blanco se esconden entre tus datos y arruinan recuentos, importaciones y SUM(). Revisamos cada fila y quitamos aquellas donde todas las celdas están vacías. Un solo valor en cualquier celda y la fila se queda.