Después de migrar archivos a OneDrive for Business, es posible que veas un error de “ruta de archivo demasiado larga”. Esto ocurre porque Windows y OneDrive tienen un límite de 260 caracteres en la longitud de la ruta. Los archivos con estructuras de carpetas profundas o nombres de archivo largos superan este límite durante o después de la migración.
La causa raíz es que la herramienta de migración copia la ruta completa desde la ubicación de origen. Si el origen tenía carpetas anidadas, la longitud combinada de la ruta en OneDrive puede superar fácilmente los 260 caracteres. OneDrive no puede sincronizar el archivo y muestra el error.
Este artículo explica cómo identificar archivos con rutas demasiado largas, acortarlas usando herramientas integradas de Windows y evitar que el error se repita. Aprenderás dos métodos para solucionar el problema sin software de terceros.
Puntos clave: Solución de errores de ruta demasiado larga después de la migración
- PowerShell Get-ChildItem con -Recurse y -Name: Lista todos los archivos cuya ruta completa supera los 260 caracteres en una carpeta determinada.
- Renombrar o mover con el Explorador de archivos: Acorta los nombres de carpeta o mueve archivos a un nivel de carpeta menos profundo para reducir la longitud de la ruta.
- Movimiento de carpeta conocida de OneDrive: Evita el error al asignar Documentos, Escritorio e Imágenes directamente a OneDrive con una ruta base corta.
Por qué ocurre el error de ruta demasiado larga después de la migración
Windows y el sistema de archivos NTFS limitan históricamente la ruta completa de un archivo a 260 caracteres. Este límite incluye la letra de unidad, dos puntos, barras invertidas, nombres de carpeta y el nombre de archivo más la extensión. OneDrive for Business aplica este mismo límite al sincronizar archivos.
Durante una migración, los archivos se copian desde una ubicación de origen, como una unidad local, un recurso compartido de red u otro servicio en la nube. Si el origen tenía carpetas anidadas a más de cinco o seis niveles, o si los nombres de carpeta son largos, la ruta resultante en OneDrive puede superar los 260 caracteres. Por ejemplo, un archivo en C:\Users\JohnDoe\Documents\Projects\2025\Q1\ClientName\Proposal\FinalDraft\v3\report.docx ya utiliza 98 caracteres antes de colocarse en OneDrive. Cuando se mueve a C:\Users\JohnDoe\OneDrive - Contoso\Documents\Projects\2025\Q1\ClientName\Proposal\FinalDraft\v3\report.docx, la ruta crece a más de 140 caracteres. Si la ruta de origen ya estaba cerca de 200 caracteres, la ruta de OneDrive superará los 260.
Microsoft ha eliminado el límite de 260 caracteres en Windows 10 versión 1607 y posteriores para aplicaciones que opten por ello. Sin embargo, OneDrive no admite rutas largas de forma nativa. El error aparece como una notificación en el centro de actividad de OneDrive: “Ruta de archivo demasiado larga” o “El nombre de archivo especificado no es válido o es demasiado largo”. El archivo permanece localmente en la carpeta de OneDrive pero no se sincroniza con la nube.
Pasos para identificar y corregir archivos con rutas que superan los 260 caracteres
Usarás PowerShell para buscar archivos con rutas de más de 260 caracteres. Luego acortarás las rutas usando el Explorador de archivos o un script. Estos pasos asumen que ya has migrado los archivos a la carpeta local de OneDrive.
- Abrir PowerShell como administrador
Presiona la tecla de Windows, escribe PowerShell, haz clic derecho en Windows PowerShell en los resultados de búsqueda y selecciona Ejecutar como administrador. Haz clic en Sí en el mensaje de Control de cuentas de usuario. - Navegar a la carpeta de OneDrive
En PowerShell, escribecd $env:OneDrivey presiona Enter. Esto cambia el directorio actual a tu carpeta de OneDrive. Si esta variable no está configurada, escribecd "C:\Users\YourUsername\OneDrive - Contoso"con tu nombre de usuario y nombre de organización reales. - Ejecutar el script de PowerShell para listar rutas largas
Copia y pega el siguiente comando en PowerShell y presiona Enter:Get-ChildItem -Recurse -Name | Where-Object { $_.Length -gt 260 } | Out-File -FilePath "$env:USERPROFILE\Desktop\LongPaths.txt"
Este comando escanea todos los archivos y carpetas de forma recursiva. Escribe las rutas relativas completas de los elementos que superan los 260 caracteres en un archivo de texto en tu escritorio llamado LongPaths.txt. El escaneo puede tardar varios minutos dependiendo del número de archivos. - Abrir el archivo LongPaths.txt
Navega a tu escritorio y abre LongPaths.txt en el Bloc de notas o cualquier editor de texto. Cada línea muestra una ruta relativa desde la raíz de OneDrive. Revisa la lista para entender qué carpetas contienen las rutas más largas. - Acortar nombres de carpeta o reestructurar carpetas
Abre el Explorador de archivos y ve a la carpeta de OneDrive. Para cada carpeta listada en LongPaths.txt, haz una de las siguientes acciones:
– Renombra las subcarpetas profundas a nombres más cortos. Por ejemplo, renombraFinalDraftaFDyProposalaProp.
– Mueve archivos de carpetas profundas a un nivel superior. Por ejemplo, muevereport.docxdesdeProposal\FinalDraft\v3directamente aProposal.
– Elimina carpetas vacías o redundantes. Haz clic derecho en una carpeta y selecciona Eliminar si no contiene archivos. - Volver a ejecutar el script de PowerShell para verificar
Después de hacer cambios, ejecuta el comando Get-ChildItem nuevamente. Si el archivo LongPaths.txt está vacío o no contiene nuevas entradas, todas las rutas están ahora por debajo de 260 caracteres. - Reiniciar la sincronización de OneDrive
Haz clic derecho en el icono de la nube de OneDrive en la bandeja del sistema y selecciona Pausar sincronización durante 2 horas. Luego haz clic derecho nuevamente y selecciona Reanudar sincronización. OneDrive volverá a escanear la carpeta y subirá los archivos previamente bloqueados.
Si OneDrive aún muestra el error después de acortar las rutas
Los archivos no están en la carpeta esperada de OneDrive
Si acortaste las rutas pero el error persiste, verifica que los archivos estén realmente dentro de la carpeta de OneDrive. Abre el Explorador de archivos y comprueba la ruta en la barra de direcciones. Debe comenzar con C:\Users\YourUsername\OneDrive - YourOrg\. Si los archivos están fuera de esta carpeta, muévelos manualmente a la carpeta de OneDrive.
La herramienta de migración creó nombres de carpeta con caracteres especiales
Algunas herramientas de migración añaden marcas de tiempo o GUID a los nombres de carpeta. Estos pueden agregar de 30 a 40 caracteres a una ruta. Renombra estas carpetas para eliminar los caracteres adicionales. Por ejemplo, renombra ProjectX_20250315_142305 a ProjectX.
La sincronización de OneDrive está bloqueada por otro archivo
Un solo archivo con una ruta larga puede bloquear toda la cola de sincronización. Si el error muestra un nombre de archivo diferente después de tu corrección, repite el escaneo de PowerShell y el proceso de acortamiento para ese nuevo archivo. Continúa hasta que el archivo LongPaths.txt esté vacío.
Archivos a petición vs. Mantener siempre en este dispositivo: Efecto en errores de longitud de ruta
| Elemento | Archivos a petición | Mantener siempre en este dispositivo |
|---|---|---|
| Descripción | Los archivos se muestran como marcadores de posición solo en línea hasta que se abren | Los archivos se descargan y se mantienen localmente en todo momento |
| Límite de longitud de ruta | 260 caracteres para la ruta del marcador de posición local | 260 caracteres para la ruta del archivo local |
| Efecto en el error | El error aún ocurre porque la ruta del marcador de posición está sujeta al mismo límite | El error aún ocurre porque la ruta completa se escribe en el disco |
| Configuración recomendada durante la migración | Desactiva Archivos a petición para forzar la descarga completa y detectar errores de ruta temprano | Usa esta configuración después de acortar rutas para asegurar que todos los archivos se sincronicen |
Después de acortar todas las rutas, puedes volver a activar Archivos a petición. Haz clic derecho en el icono de la nube de OneDrive, selecciona Configuración, ve a la pestaña Sincronización y copia de seguridad, y en Archivos a petición, marca Ahorrar espacio y descargar archivos a medida que los uses.
Ahora puedes escanear tu carpeta de OneDrive en busca de archivos con rutas que superen los 260 caracteres usando PowerShell y acortarlos manualmente. Para evitar este error en futuras migraciones, usa una estructura de carpetas de no más de cuatro niveles y mantén los nombres de carpeta por debajo de 20 caracteres. Para protección continua, habilita la política de soporte de rutas largas de Windows en Directiva de grupo en Configuración del equipo > Plantillas administrativas > Sistema > Sistema de archivos > Habilitar rutas largas de Win32, aunque OneDrive seguirá aplicando su propio límite.