Nombre de archivo demasiado largo bloquea una biblioteca empresarial: solución para OneDrive for Business

Cuando un nombre de archivo o la ruta completa a un archivo supera los límites de caracteres de Windows o OneDrive, el archivo no se sincroniza y bloquea toda la biblioteca. Este problema comúnmente detiene la carga de nuevos archivos, impide que los cambios se guarden y muestra un error en el estado de sincronización de OneDrive. La causa raíz es que OneDrive for Business aplica un límite de 400 caracteres para la ruta completa del archivo, incluido el nombre del archivo. Este artículo explica por qué existe este límite y proporciona tres métodos para localizar y renombrar o mover los archivos que bloquean la sincronización.

Por qué OneDrive bloquea archivos con rutas largas

OneDrive for Business utiliza el sistema de archivos NTFS en Windows, que tiene una longitud máxima de ruta de 32,767 caracteres para aplicaciones que habilitan el soporte de rutas largas. Sin embargo, OneDrive mismo aplica un límite más estricto de 400 caracteres para la ruta completa, incluido el nombre del archivo. Este límite se aplica a la longitud combinada de la letra de unidad, la estructura de carpetas y el nombre del archivo. Cuando cualquier archivo o carpeta en una biblioteca sincronizada supera este límite, OneDrive deja de sincronizar ese archivo y cualquier archivo en la misma jerarquía de carpetas. La biblioteca muestra un estado de error y los usuarios no pueden cargar, editar o eliminar archivos hasta que se resuelva el archivo bloqueado. El límite existe para mantener el rendimiento durante las operaciones de sincronización y para evitar problemas cuando los archivos se acceden en otras plataformas o a través de SharePoint Online, que también aplica un límite de 400 caracteres para las URL.

Cómo se calcula el límite de 400 caracteres

El límite de 400 caracteres incluye la ruta de carpeta local en su computadora más el nombre del archivo. Por ejemplo, si su carpeta de OneDrive está ubicada en C:\Users\SuNombre\OneDrive – Contoso, ese prefijo tiene 38 caracteres. Una estructura de carpetas bajo esa ruta como Proyectos\2025\Q1\Entregables del Cliente agrega otros 40 caracteres. Si el nombre del archivo en sí tiene 330 caracteres, el total supera los 400 y el archivo no se sincronizará. SharePoint Online tiene un límite similar de 400 caracteres para la ruta de URL. Esto significa que los archivos que se sincronizan desde SharePoint a OneDrive también están sujetos a esta restricción.

Pasos para encontrar y solucionar el archivo bloqueado

Los siguientes métodos le ayudan a localizar el archivo con la ruta larga y luego renombrarlo o moverlo para que OneDrive pueda reanudar la sincronización.

Método 1: Usar el mensaje de error de OneDrive

1. Abra el estado de sincronización de OneDrive
   Haga clic en el icono de nube de OneDrive en la bandeja del sistema, cerca del reloj. Si ve un círculo rojo con una X blanca, pase el cursor sobre él. Aparece un mensaje emergente que muestra el nombre del archivo y el error: “El nombre del archivo es demasiado largo” o “La ruta es demasiado larga”.
2. Anote la ruta completa del archivo
   El mensaje de error muestra la ruta relativa desde la raíz de OneDrive. Escriba la carpeta y el nombre del archivo exactamente como se muestra. Este es el archivo que bloquea la biblioteca.
3. Navegue al archivo en el Explorador de archivos
   Abra el Explorador de archivos y vaya a su carpeta de OneDrive. Use la ruta del mensaje de error para localizar el archivo. Si la ruta de la carpeta es larga, es posible que deba expandir cada subcarpeta manualmente.
4. Renombre o mueva el archivo
   Haga clic derecho en el archivo y seleccione Renombrar. Acorte el nombre del archivo a menos de 100 caracteres. Alternativamente, mueva el archivo a una carpeta de nivel superior para reducir la longitud de la ruta. Después del cambio, OneDrive reanuda la sincronización en unos segundos.

Método 2: Ordenar archivos por longitud de ruta en el Explorador de archivos

1. Abra su carpeta de OneDrive
   Presione la tecla de Windows + E para abrir el Explorador de archivos. Navegue a la ubicación de su carpeta de OneDrive, típicamente C:\Users\SuNombre\OneDrive – NombreDeEmpresa.
2. Agregue la columna Ruta
   Haga clic derecho en cualquier encabezado de columna como Nombre o Fecha de modificación. Haga clic en Más. En el cuadro de diálogo Elegir detalles, desplácese hacia abajo, marque la casilla para Ruta y haga clic en Aceptar. La columna Ruta ahora muestra la ruta completa de cada archivo.
3. Ordene por longitud de ruta
   Haga clic en el encabezado de la columna Ruta para ordenar los archivos alfabéticamente por ruta. Los archivos en carpetas más profundas aparecen cerca del final. Examine manualmente los archivos con rutas muy largas. Una ruta de más de 400 caracteres aparecerá como una cadena muy larga en la columna Ruta.
4. Renombre o mueva los archivos identificados
   Para cada archivo con una ruta excesivamente larga, haga clic derecho y seleccione Renombrar. Acorte el nombre a menos de 50 caracteres. Si varios archivos comparten una ruta de carpeta larga, considere mover toda la carpeta a un nivel superior en la estructura de OneDrive.

Método 3: Usar PowerShell para listar archivos con rutas largas

1. Abra PowerShell como administrador
   Presione la tecla de Windows, escriba PowerShell, haga clic derecho en Windows PowerShell y seleccione Ejecutar como administrador. Haga clic en Sí en el mensaje de Control de cuentas de usuario.
2. Ejecute el comando Get-ChildItem
   Escriba el siguiente comando y presione Enter:
   Get-ChildItem -Path "C:\Users\YourName\OneDrive - CompanyName" -Recurse | Where-Object { $_.FullName.Length -gt 400 } | Select-Object FullName
   Reemplace la ruta con la ubicación real de su carpeta de OneDrive. Este comando lista cada archivo cuya ruta completa supera los 400 caracteres.
3. Revise la salida
   La ventana de PowerShell muestra la ruta completa de cada archivo que excede el límite. Copie cada ruta en el Bloc de notas para referencia.
4. Renombre o mueva cada archivo
   Para cada archivo en la lista, navegue a su ubicación en el Explorador de archivos. Acorte el nombre del archivo o muévalo a una carpeta menos profunda. Después de hacer los cambios, ejecute el comando de PowerShell nuevamente para confirmar que no queden archivos con más de 400 caracteres.

Si OneDrive aún muestra un error después de la solución principal

Después de renombrar o mover el archivo bloqueado, OneDrive puede seguir mostrando un error. Los siguientes escenarios explican por qué y cómo resolverlos.

OneDrive muestra una X roja en el icono de la carpeta

Una X roja en una carpeta en lugar de un archivo significa que el nombre de la carpeta en sí es demasiado largo. La ruta combinada de la jerarquía de carpetas supera los 400 caracteres incluso antes de agregar nombres de archivo. Para solucionarlo, renombre la carpeta a un nombre más corto o muévala a un nivel superior en la estructura de OneDrive. Por ejemplo, cambie “2025 Marketing Campaign Q1 Drafts Final Review” a “2025-Marketing-Q1”. Después de renombrar la carpeta, todos los archivos dentro de ella se sincronizarán normalmente.

OneDrive deja de sincronizar toda la biblioteca

Si OneDrive deja de sincronizar toda la biblioteca después de solucionar un archivo, puede existir un segundo archivo con una ruta larga más profundo en la estructura de carpetas. Ejecute el comando de PowerShell del Método 3 nuevamente para verificar si hay archivos adicionales. Repita los pasos de renombrar o mover para cada archivo hasta que el comando no devuelva resultados. Después de solucionar el último archivo, OneDrive reanuda la sincronización de toda la biblioteca.

El mensaje de error de OneDrive dice que el nombre del archivo contiene caracteres no válidos

Algunos archivos con nombres largos también contienen caracteres que Windows o SharePoint no permiten, como “, :, /, \, |, <, >, o ?. Si el mensaje de error menciona caracteres no válidos además de la longitud, renombre el archivo para eliminar esos caracteres. Use solo letras, números, espacios, guiones, guiones bajos y puntos. Después de eliminar los caracteres no válidos, el archivo se sincroniza siempre que la ruta total esté por debajo de 400 caracteres.

Elemento	OneDrive for Business	SharePoint Online
Longitud máxima de ruta	400 caracteres	400 caracteres
Longitud máxima del nombre de archivo	255 caracteres	255 caracteres
Caracteres no válidos en el nombre de archivo	~ # % & : < > ? / \ { | }	~ # % & : < > ? / \ { | }
Comportamiento de sincronización cuando se excede el límite	El archivo no se carga; se muestra un error en el estado de sincronización	El archivo no se carga; se muestra un error en la biblioteca
Método de solución	Renombrar o mover el archivo localmente; el cambio se sincroniza automáticamente	Renombrar o mover el archivo en el navegador; el cambio se sincroniza con OneDrive

Después de renombrar o mover el archivo bloqueado, OneDrive reanuda automáticamente la sincronización de toda la biblioteca. Para prevenir este error en el futuro, establezca una convención de nombres que mantenga los nombres de archivo por debajo de 100 caracteres y limite la profundidad de carpetas a cinco niveles. Si su equipo trabaja frecuentemente con estructuras de carpetas profundas, use el comando de PowerShell como una verificación semanal para detectar rutas largas antes de que bloqueen la biblioteca.