Cómo evitar el error de nombre de archivo demasiado largo durante la sincronización

Cuando sincroniza archivos de SharePoint o OneDrive con su equipo, el proceso de sincronización puede detenerse con un error de nombre de archivo demasiado largo. Este error ocurre porque Windows y OneDrive tienen un límite combinado de longitud de ruta de 400 caracteres. El error impide que la carpeta o el archivo se sincronicen y puede bloquear toda la cola de sincronización.

La causa principal es que SharePoint permite rutas de archivo de hasta 400 caracteres, pero al sincronizar, la ruta local completa (incluida la estructura de carpetas de su equipo) supera este límite. Este artículo explica cómo identificar y corregir rutas de archivo largas antes de que causen fallos de sincronización. Aprenderá pasos específicos para acortar nombres de carpeta, reestructurar bibliotecas y usar la configuración de OneDrive para evitar el error.

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

El error de nombre de archivo demasiado largo ocurre debido al límite de longitud de ruta de 400 caracteres impuesto por la aplicación de sincronización de OneDrive. Cuando sincroniza una biblioteca de SharePoint con su equipo, la aplicación de sincronización crea una copia local de la estructura de carpetas. La ruta completa a un archivo incluye la carpeta de usuario de Windows, la carpeta raíz de OneDrive, el nombre del sitio de SharePoint y todas las carpetas anidadas.

SharePoint en sí admite rutas de hasta 400 caracteres. Sin embargo, la ruta local agrega caracteres de la letra de unidad de su equipo, el nombre de usuario y el nombre de la carpeta de OneDrive. Por ejemplo, un archivo en C:\Users\JohnDoe\OneDrive - Contoso\Shared Documents\Project Alpha\Reports\Q4\Final\draft-v3.docx contiene 97 caracteres solo del prefijo local. Si la ruta del lado de SharePoint es de 310 caracteres, el total supera los 400 y la sincronización falla.

El error aparece como un círculo rojo con una cruz blanca en el icono de la bandeja del sistema de OneDrive. La aplicación de sincronización muestra una notificación que dice “Nombre de archivo demasiado largo” y enumera el archivo afectado. La cola de sincronización deja de procesar todos los archivos hasta que solucione el problema de ruta.

Límites de caracteres para diferentes escenarios de sincronización

El límite de 400 caracteres se aplica a la ruta local completa. Si sincroniza en una unidad externa o en una ubicación de red, la longitud de la ruta puede ser más corta debido a la profundidad adicional de carpetas. La aplicación de sincronización de OneDrive también limita los nombres de archivo individuales a 255 caracteres. Los nombres de carpeta pueden tener hasta 250 caracteres, pero combinar muchas carpetas profundas consume rápidamente el presupuesto de ruta.

Pasos para identificar y corregir rutas de archivo largas

Use estos pasos para encontrar archivos con rutas largas y acortarlos antes de que falle la sincronización.

1. Abra la configuración de la aplicación de sincronización de OneDrive
   Haga clic derecho en el icono de nube de OneDrive en la bandeja del sistema. Seleccione Configuración. Vaya a la pestaña Red. En Límite de longitud de ruta de archivo, marque la casilla que dice “Aplicar el límite de longitud de ruta de 400 caracteres”. Haga clic en Aceptar. Esta configuración evita que los archivos con rutas de más de 400 caracteres se sincronicen y muestra una advertencia en lugar de un fallo silencioso.
2. Compruebe el estado de sincronización para ver advertencias de rutas largas
   En el icono de la bandeja del sistema de OneDrive, haga clic en el icono de nube y seleccione Ver problemas de sincronización. La lista muestra archivos con errores de longitud de ruta. Anote la ruta completa de cada archivo bloqueado.
3. Abra la biblioteca de documentos de SharePoint en un navegador
   Vaya al sitio de SharePoint que contiene la biblioteca sincronizada. Navegue a la biblioteca de documentos donde residen los archivos con rutas largas. Haga clic en el nombre de la biblioteca en el encabezado y seleccione Configuración de biblioteca.
4. Agregue la columna Longitud de ruta a la vista de la biblioteca
   En Configuración de biblioteca, haga clic en Crear columna. Nombre la columna “Longitud de ruta”. Elija Calculada como tipo de columna. En el cuadro de fórmula, ingrese =LEN([Full Path]). Haga clic en Aceptar. Vuelva a la biblioteca y agregue esta columna a su vista actual. La columna muestra el recuento de caracteres de la ruta de SharePoint de cada archivo.
5. Ordene los archivos por Longitud de ruta descendente
   Haga clic en el encabezado de la columna Longitud de ruta para ordenar de mayor a menor. Identifique los archivos con una longitud de ruta superior a 350 caracteres. Estos archivos están en riesgo de superar el límite de 400 caracteres cuando se combinan con el prefijo de ruta local.
6. Acorte los nombres de carpetas y archivos
   Para cada archivo en riesgo, cambie el nombre de las carpetas o del archivo para reducir la longitud total de la ruta. Use abreviaturas para los nombres de carpeta. Por ejemplo, cambie “Informes financieros trimestrales” a “QtrFinancial”. Mantenga los nombres de archivo por debajo de 50 caracteres. Después de cambiar el nombre, la columna Longitud de ruta se actualiza automáticamente.
7. Mueva archivos a un nivel de carpeta menos profundo
   Si cambiar el nombre no es suficiente, mueva los archivos uno o dos niveles de carpeta hacia arriba. Cree una nueva carpeta en la raíz de la biblioteca con un nombre corto. Mueva los archivos profundos a esa carpeta. Actualice cualquier enlace o referencia a la nueva ubicación.
8. Reinicie la sincronización de OneDrive
   Después de realizar cambios, haga clic derecho en el icono de OneDrive y seleccione Pausar sincronización durante 2 horas. Espere 30 segundos y luego haga clic en Reanudar sincronización. La aplicación de sincronización vuelve a evaluar todos los archivos y debería procesar las rutas acortadas sin error.

Si SharePoint aún tiene problemas después de acortar las rutas

La sincronización aún falla incluso después de cambiar el nombre de los archivos

Si el error persiste, el prefijo de ruta local puede ser más largo de lo esperado. Verifique la ubicación de su carpeta local de OneDrive. Vaya a Configuración de OneDrive > pestaña Cuenta > Elegir carpetas. Anote la ruta raíz que se muestra en Su carpeta de OneDrive. Si su nombre de usuario de Windows es largo o la letra de unidad es profunda, considere mover la carpeta de OneDrive a una ruta más corta. En Configuración de OneDrive > Copia de seguridad > Administrar copia de seguridad, haga clic en Cambiar ubicación y seleccione una carpeta raíz como C:\OneDrive en lugar de C:\Users\LongName\OneDrive.

Los nombres de carpeta en SharePoint son demasiado largos para editarlos

Si una carpeta tiene un nombre de más de 100 caracteres, SharePoint puede negarse a cambiarle el nombre. En este caso, cree una nueva carpeta con un nombre corto en el mismo nivel. Seleccione todos los archivos de la carpeta de nombre largo, haga clic en Mover a y elija la nueva carpeta. Elimine la carpeta vacía original después de confirmar que todos los archivos se movieron.

La sincronización de OneDrive muestra “Ruta demasiado larga” para un solo archivo

Un solo archivo con un nombre muy largo puede bloquear toda la cola de sincronización. Abra SharePoint en un navegador. Navegue hasta el archivo. Haga clic en el nombre del archivo y seleccione Cambiar nombre. Acorte el nombre a 50 caracteres o menos. La cola de sincronización reanuda el procesamiento de otros archivos en unos minutos.

Elemento	Límite de ruta de SharePoint	Límite de ruta de sincronización local
Ruta total máxima	400 caracteres	400 caracteres (prefijo local incluido)
Nombre de archivo individual	255 caracteres	255 caracteres
Nombre de carpeta individual	250 caracteres	250 caracteres
Ejemplo de prefijo local predeterminado	N/A	C:\Users\Name\OneDrive - Company\ (aprox. 40-60 caracteres)
Ruta máxima recomendada de SharePoint	350 caracteres	350 caracteres para dejar espacio para el prefijo local

Después de aplicar los pasos de este artículo, puede evitar el error de nombre de archivo demasiado largo durante la sincronización. Comience habilitando la aplicación del límite de longitud de ruta en la configuración de OneDrive. Luego use la columna Longitud de ruta en SharePoint para monitorear y acortar rutas profundas. Para la gestión continua, establezca una convención de nombres que mantenga los nombres de carpetas y archivos por debajo de 50 caracteres cada uno. Esta práctica reduce la posibilidad de alcanzar el límite de 400 caracteres incluso a medida que su biblioteca crece.