Error de nombre de archivo demasiado largo durante la sincronización: causa y solución

Al sincronizar archivos desde SharePoint o OneDrive a tu computadora con Windows, es posible que veas un mensaje de error que indica que el nombre del archivo es demasiado largo. Esto detiene el proceso de sincronización para ese archivo y, a veces, para toda la biblioteca. El error ocurre porque Windows tiene un límite máximo de longitud de ruta de 260 caracteres, y la ruta completa, incluidos los nombres de las carpetas, supera este límite. Este artículo explica por qué existe este límite, cómo identificar los archivos que causan el error y los pasos para solucionar el problema renombrando archivos o moviéndolos a rutas más cortas.

Por qué ocurre el error de nombre de archivo demasiado largo durante la sincronización

El error se debe a la limitación MAX_PATH en el sistema operativo Windows. Este límite restringe el número total de caracteres en una ruta de archivo a 260 caracteres. La ruta incluye la letra de la unidad, dos puntos, barra invertida, todos los nombres de carpetas, el nombre del archivo y la extensión. Por ejemplo, un archivo ubicado en C:\Users\YourName\OneDrive - Company\Projects\2024\Q1\Marketing\Campaign\Assets\Images\Final\Header\background-image-v2-final.jpg puede superar fácilmente los 260 caracteres.

La aplicación de sincronización de OneDrive respeta esta limitación de Windows. Cuando intenta sincronizar un archivo cuya ruta completa supera los 260 caracteres, Windows devuelve un error. La aplicación de sincronización detiene el procesamiento de ese archivo y reporta el error en el estado de sincronización. El archivo permanece sin sincronizar y cualquier cambio en él no se cargará ni descargará hasta que se reduzca la longitud de la ruta.

Este problema es más común en bibliotecas de documentos de SharePoint porque los usuarios suelen crear estructuras de carpetas profundamente anidadas. Una biblioteca con cinco o más niveles de subcarpetas combinados con nombres de archivo largos puede alcanzar rápidamente el límite de 260 caracteres. El error también puede ocurrir al sincronizar una gran cantidad de archivos a la vez, ya que la aplicación de sincronización procesa la ruta completa de cada archivo.

Pasos para identificar y corregir el error de nombre de archivo demasiado largo

1. Revisa la notificación de error de sincronización de OneDrive
   Abre el icono de OneDrive en la bandeja del sistema. Si hay un círculo rojo con una cruz blanca, pasa el cursor sobre el icono para ver el mensaje de error. Haz clic en el icono y selecciona “Ver problemas de sincronización” para ver la lista de archivos que no se sincronizaron. El mensaje de error dirá “El nombre del archivo es demasiado largo” y mostrará la ruta completa del archivo.
2. Localiza el archivo en SharePoint o OneDrive en línea
   Abre un navegador web y ve al sitio de SharePoint o OneDrive donde está almacenado el archivo. Navega a la ruta de carpeta que se muestra en el mensaje de error. Puedes copiar la ruta del mensaje de error y pegarla en la barra de direcciones del navegador después de la URL del sitio para saltar directamente a la carpeta.
3. Renombra el archivo a un nombre más corto
   Selecciona el archivo y haz clic en “Cambiar nombre” en la barra de herramientas. Cambia el nombre del archivo a una versión más corta. Por ejemplo, cambia background-image-v2-final.jpg a bg-v2.jpg. Mantén el nombre del archivo por debajo de 30 caracteres si es posible. Esto reduce la longitud total de la ruta.
4. Mueve el archivo a una carpeta menos profunda
   Si renombrar no es suficiente, mueve el archivo a una carpeta más cercana a la raíz de la biblioteca. Corta el archivo y pégalo en una carpeta de nivel superior. También puedes crear una nueva carpeta con un nombre corto en el nivel raíz y mover el archivo allí.
5. Reestructura la jerarquía de carpetas
   Para problemas recurrentes, considera aplanar la estructura de carpetas. Limita el anidamiento a tres niveles de profundidad. Usa columnas de metadatos y vistas en SharePoint para organizar archivos en lugar de crear subcarpetas profundas. Por ejemplo, usa una columna “Año” y una columna “Proyecto” en lugar de carpetas como \2024\Q1\Marketing\Campaign\.
6. Habilita el soporte para rutas largas en Windows
   En Windows 10 versión 1607 y posteriores, y en Windows 11, puedes habilitar el soporte para rutas de más de 260 caracteres. Esto elimina la limitación para aplicaciones que son conscientes de esta configuración, incluida la aplicación de sincronización de OneDrive. Para habilitarlo, abre el Editor de directivas de grupo escribiendo gpedit.msc en el cuadro de diálogo Ejecutar. Navega a Configuración del equipo > Plantillas administrativas > Sistema > Sistema de archivos. Haz doble clic en “Habilitar rutas largas de Win32” y establécelo en Habilitado. Reinicia tu computadora. Si el Editor de directivas de grupo no está disponible, usa el registro: abre el Editor del registro y ve a HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem. Establece LongPathsEnabled en 1. Reinicia tu computadora.
7. Reanuda la sincronización después de corregir
   Después de renombrar o mover el archivo, la aplicación de sincronización de OneDrive debería reintentar automáticamente la sincronización. Si no lo hace, haz clic derecho en el icono de OneDrive en la bandeja del sistema y selecciona “Reanudar sincronización”. También puedes pausar y reanudar la sincronización desde el mismo menú.

Si el error de sincronización persiste después de corregir los nombres de archivo

Los archivos siguen mostrando el error después de renombrarlos

Si el error continúa, verifica si otro archivo en la misma carpeta también tiene una ruta larga. La aplicación de sincronización reporta un archivo a la vez, pero puede haber varios archivos afectados. Revisa la lista completa de problemas de sincronización haciendo clic en “Ver problemas de sincronización” en la configuración de OneDrive. Renombra o mueve cada archivo listado.

El error aparece para archivos en la raíz de la biblioteca

Si un archivo en la carpeta raíz muestra el error, el nombre del archivo en sí es demasiado largo. Los nombres de archivo deben mantenerse por debajo de 100 caracteres. Renombra el archivo a un nombre más corto. También verifica si la ruta de la carpeta local en tu computadora es larga. La ruta completa incluye la ubicación de la carpeta de OneDrive, que puede agregar caracteres. Por ejemplo, C:\Users\YourName\OneDrive - Company\ puede tener 40 caracteres o más. Mueve la carpeta de OneDrive a una ruta más corta como C:\OneDrive\ cambiando la configuración de OneDrive.

El error ocurre solo en una computadora específica

Si el mismo archivo se sincroniza correctamente en otra computadora pero falla en esta, la longitud de la ruta local difiere. Verifica si la computadora tiene un nombre de usuario largo o una estructura de carpetas profunda en la ubicación de sincronización de OneDrive. Acorta el nombre de la carpeta de usuario creando una nueva cuenta de usuario de Windows con un nombre corto y reconfigurando OneDrive bajo esa cuenta.

Método	Efectividad	Cuándo usar
Renombrar el archivo	Solución rápida para archivos individuales	Cuando solo unos pocos archivos tienen nombres largos
Mover el archivo a una carpeta menos profunda	Reduce la longitud de la ruta sin renombrar	Cuando los nombres de carpeta son largos pero el nombre del archivo es corto
Reestructurar la jerarquía de carpetas	Previene errores futuros	Cuando la biblioteca tiene anidamiento profundo
Habilitar soporte para rutas largas	Solución permanente a nivel de sistema	Cuando los usuarios necesitan estructuras de carpetas profundas

Después de aplicar cualquiera de estos métodos, puedes reanudar la sincronización de los archivos que estaban bloqueados. La aplicación de sincronización de OneDrive procesará las rutas corregidas y cargará o descargará los archivos correctamente.