Error de importación en Mastodon: error ‘CSV no válido’ y cómo solucionarlo

Subiste un archivo CSV a Mastodon para importar seguidores o bloqueos, y el servidor lo rechazó con un error CSV no válido. Este error generalmente significa que la estructura del archivo no coincide con lo que Mastodon espera. El problema suele residir en encabezados de columna incorrectos, caracteres de comillas adicionales o texto suelto fuera de las filas de datos.

Mastodon requiere que los archivos CSV tengan una fila de encabezado específica y un formato simple separado por comas. Los archivos exportados desde otras redes sociales o editados en software de hojas de cálculo a menudo introducen un formato que Mastodon no puede analizar. Este artículo explica el formato CSV exacto que Mastodon espera y proporciona soluciones paso a paso para corregir tu archivo.

Después de leer esta guía, podrás identificar por qué tu archivo CSV no es válido, reformatearlo correctamente y completar con éxito la importación en Mastodon.

Por qué Mastodon rechaza archivos CSV con el error de CSV no válido

Mastodon importa listas de seguimiento, listas de bloqueo y bloqueos de dominio a través de archivos CSV. El sistema de importación espera un formato muy estricto. El archivo debe ser texto plano sin marca de orden de bytes (BOM), sin espacios en blanco adicionales alrededor de los valores y sin campos entre comillas a menos que el campo contenga una coma.

La causa raíz más común es la fila de encabezado. Mastodon busca el encabezado exacto Account address,Show boosts para las importaciones de seguimiento. Si el encabezado dice Account Address con A mayúscula, o Account address,show boosts con s minúscula, el servidor devuelve CSV no válido.

Otra causa frecuente es la presencia de comillas dobles alrededor de cada campo. Mastodon solo acepta campos entre comillas cuando el campo en sí contiene una coma. Por ejemplo, un nombre de usuario como "@user@example.com" está bien, pero "@user@example.com" con comillas alrededor de cada fila no lo está. Los programas de hojas de cálculo como Excel o Google Sheets a menudo exportan cada celda con comillas, lo que rompe la importación.

Finalmente, los caracteres ocultos como retornos de carro, saltos de línea que no son consistentes o una BOM al inicio del archivo pueden hacer que el analizador falle. Los archivos guardados con codificación UTF-8 con BOM son un culpable común al exportar desde Notepad de Windows o Excel.

Pasos para corregir el error de CSV no válido y completar la importación

1. Abre el archivo CSV en Notepad u otro editor de texto plano
   No uses Excel ni Google Sheets para editarlo. Haz clic derecho en el archivo, selecciona Abrir con y elige Notepad. Esto muestra el texto sin formato sin ningún formato oculto.
2. Verifica la primera fila para el encabezado exacto
   Para una importación de seguimiento, la primera línea debe ser Account address,Show boosts exactamente. Para una importación de bloqueo, el encabezado debe ser Account address únicamente. Si ves espacios adicionales, mayúsculas diferentes o columnas adicionales, edita el encabezado para que coincida exactamente.
3. Elimina todas las comillas dobles del archivo
   Usa la función Reemplazar de Notepad. Presiona Ctrl+H. En Buscar, escribe una comilla doble. Deja Reemplazar con vacío. Haz clic en Reemplazar todo. Esto elimina todos los caracteres de comillas. Mastodon volverá a añadir comillas automáticamente donde sea necesario durante la importación.
4. Elimina las comas finales de cada línea
   Busca líneas que terminen con una coma después del último valor. Elimina esas comas finales. Cada línea debe terminar con el último valor seguido de un salto de línea.
5. Guarda el archivo con codificación UTF-8 sin BOM
   En Notepad, ve a Archivo > Guardar como. En la parte inferior, establece Codificación en UTF-8. No elijas UTF-8 con BOM. Nombra el archivo con extensión .csv y guárdalo en tu escritorio.
6. Prueba el archivo importando un subconjunto pequeño
   Crea un CSV de prueba con solo dos o tres cuentas. Súbelo a Mastodon a través de Preferencias > Importar y exportar > Importar. Selecciona el tipo correcto (Siguiendo, Bloqueando, etc.) y haz clic en Subir. Si esto tiene éxito, tu archivo principal aún tiene un problema. Si también falla, el formato sigue siendo incorrecto.
7. Vuelve a subir el CSV corregido a Mastodon
   Ve a Preferencias > Importar y exportar > Importar. Elige el tipo que coincida con tu CSV. Haz clic en Examinar y selecciona tu archivo corregido. Haz clic en Subir. Mastodon procesará el archivo y mostrará un mensaje de éxito o una lista de entradas fallidas.

Corregir archivos CSV exportados desde Twitter u otras plataformas

Si estás migrando desde Twitter, el CSV exportado tiene una estructura diferente. Las exportaciones de Twitter incluyen columnas como username, name y bio. Mastodon ignora esas columnas pero aún requiere la fila de encabezado correcta. Debes eliminar todas las columnas excepto Account address y Show boosts. Luego cambia el nombre del encabezado para que coincida con el formato de Mastodon.

Abre el CSV de Twitter en Notepad. Elimina todo excepto las dos columnas requeridas. Asegúrate de que la fila de encabezado sea Account address,Show boosts. Elimina cualquier texto adicional en la parte superior del archivo, como una línea de resumen o fecha de exportación. Guarda el archivo como UTF-8 sin BOM.

Si el error de CSV no válido persiste después de corregir el archivo

El archivo contiene una BOM que Notepad no puede eliminar

Algunos editores de texto, incluidas versiones antiguas de Notepad, añaden una BOM al guardar con codificación UTF-8. Para eliminar la BOM, abre el archivo en un editor más capaz como Visual Studio Code o Sublime Text. En Visual Studio Code, haz clic en el indicador de codificación en la parte inferior de la ventana (generalmente dice UTF-8 con BOM). Selecciona Guardar con codificación y elige UTF-8. Esto elimina la BOM.

El archivo CSV tiene más de 5000 filas y se agota el tiempo

El proceso de importación de Mastodon puede manejar archivos grandes, pero las importaciones muy grandes pueden agotar el tiempo de espera. Si tu archivo tiene más de 5000 filas, divídelo en fragmentos más pequeños de 1000 filas cada uno. Sube cada fragmento por separado. Usa una herramienta como split CSV online o copia manualmente las filas en archivos separados.

La importación tiene éxito pero no aparecen seguidores

Esto ocurre cuando las direcciones de cuenta en el CSV no son identificadores de Mastodon válidos. Cada dirección debe tener el formato @username@instance.domain. Verifica que cada fila contenga un identificador completo. Los identificadores parciales como @username sin dominio serán ignorados. También verifica que las cuentas existan y no estén suspendidas.

Importación CSV de Mastodon: formato esperado vs errores comunes

Elemento	Formato correcto	Error común
Fila de encabezado para following	Account address,Show boosts	account address,show boosts o Account,Show
Fila de encabezado para blocking	Account address	Account address, con coma final
Formato de dirección de cuenta	@user@example.com	user@example.com sin el @ inicial
Comillas	Solo alrededor de campos que contienen comas	Comillas alrededor de cada campo
Codificación de archivo	UTF-8 sin BOM	UTF-8 con BOM o ANSI
Finales de línea	Solo LF estilo Unix	CR+LF de Windows que causan líneas en blanco adicionales

Ahora puedes inspeccionar cualquier archivo CSV, corregir el encabezado y la codificación, e importarlo a Mastodon sin ver el error de CSV no válido. La próxima vez que necesites migrar seguidores, usa la función de exportación de tu cuenta anterior para obtener un archivo que ya coincida con el formato esperado. Para solucionar problemas avanzados, habilita las herramientas de desarrollador en tu navegador y revisa la respuesta de red del punto de conexión de la API de importación; a menudo devuelve un mensaje de error más detallado que el que muestra la interfaz web.