Límite de longitud de ruta y de nombres de archivo en SharePoint: corrígelos antes de migrar
Por Mirko Peters · · Actualizado
El límite de longitud de URL de SharePoint es de 400 caracteres para la ruta de archivo decodificada. Busca rutas largas y nombres no válidos antes de migrar con esta lista de comprobación.
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
El límite de longitud de URL de SharePoint es de 400 caracteres para la ruta de archivo decodificada, incluido el nombre del archivo. Lo que supere ese límite no se puede subir, copiar ni sincronizar, y los usuarios ven un error en lugar del archivo. Esta lista de comprobación está pensada para los responsables de una migración a SharePoint que quieran localizar en el origen las rutas largas y los nombres no válidos antes de la primera copia, porque renombrar después de la migración es más lento y arriesgado. Aprenderás qué documenta Microsoft, qué deja poco claro y cómo corregir primero las rutas más largas.
Puntos clave
- Microsoft documenta un límite de 400 caracteres para la ruta de archivo completa decodificada, incluido el nombre del archivo, en OneDrive y SharePoint.
- Windows añade sus propios límites: las aplicaciones de escritorio de Office no pueden abrir archivos cuya ruta completa supere los 260 caracteres, aunque la nube acepte el archivo.
- Entre los caracteres no válidos están las comillas dobles, el asterisco, los dos puntos, los signos de menor y mayor que, el signo de interrogación, las barras y la barra vertical, y no se permiten los espacios al principio ni al final.
- Las fuentes no coinciden en cómo contar los caracteres codificados frente a los decodificados ni en el punto de partida, así que cuenta desde /sites y mantén un margen de seguridad en tus comprobaciones.
- Mide las rutas en el origen, corrige primero las más largas acortando los nombres de las carpetas y renombra los archivos antes de copiarlos, no después.
Límite de longitud de URL de SharePoint: lo que documenta Microsoft
Microsoft indica el límite de 400 caracteres para SharePoint Online en dos lugares. La descripción del servicio SharePoint limits dice que la ruta de archivo completa decodificada, incluido el nombre del archivo, no puede contener más de 400 caracteres en OneDrive y SharePoint en Microsoft 365. El artículo de ayuda What are the file path length limits? da el mismo número y añade detalles. Ninguna de las dos páginas describe una configuración que permita aumentar el límite, así que planifica en torno a él.
Puntos clave de ese artículo:
- Cuenta cada carpeta de la jerarquía y el nombre del archivo con su extensión. Cuenta cada carácter, incluidos los separadores, los espacios y la extensión.
- Office para la web usa los mismos 400 caracteres.
- En SharePoint, los caracteres especiales, los espacios y los caracteres acentuados se codifican como URL. Un espacio se convierte en
%20.
El punto de la codificación es donde las páginas no coinciden. El artículo de ayuda indica que las formas codificadas cuentan para el límite, pero su regla principal se refiere a la ruta decodificada. La descripción del servicio solo menciona la ruta decodificada. La siguiente sección muestra qué otros puntos apuntan en direcciones distintas.
Cómo cuenta SharePoint los caracteres
Tres fuentes responden a la pregunta de cómo contar, y no coinciden del todo.
- ¿Decodificada o codificada? Una respuesta aceptada en Microsoft Q&A, escrita por personal externo de Microsoft, indica que la longitud de la ruta se calcula sobre la ruta decodificada y remite al artículo de restricciones. El anuncio de 2017 decía lo mismo: Redmondmag cita a Bill Baer, de Microsoft, con "No hay ningún límite para las URL codificadas en SharePoint Online y OneDrive para la Empresa." La nota del artículo de ayuda que indica que
%20cuenta es la excepción. - ¿Dónde empieza el recuento? Otra respuesta de Microsoft Q&A, de personal externo de Microsoft, indica que hay que empezar en el segmento
/sitesy omitir los parámetros de la cadena de consulta. En un enlace como/sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=..., solo cuenta la parte anterior al signo de interrogación. Según esa respuesta, cuentan el nombre del sitio y el nombre de la biblioteca. El propio ejemplo del artículo de ayuda empieza en la raíz de la biblioteca, así que considera la respuesta de Q&A como orientación de soporte, no como documentación. - ¿Y el nombre del servidor? La fórmula que Redmondmag recogió en 2017 dice: protocolo más nombre del servidor más ruta de la carpeta o archivo más nombre de la carpeta o archivo más parámetros. Es distinta de la respuesta de soporte, y es un motivo más para no hacer un recuento ajustado.
De aquí se deduce una regla prudente. Cuenta desde /sites, incluye el nombre del sitio, el nombre de la biblioteca, todas las carpetas y el nombre del archivo, y deja un margen de unas decenas de caracteres hasta que pruebes un caso límite real en tu inquilino.
¿Ha aumentado Microsoft el límite de la ruta?
Una vez, según Redmondmag. En mayo de 2017, el artículo informaba de que Microsoft había ampliado la longitud máxima de la ruta de URL para SharePoint Online y OneDrive para la Empresa de 256 a 400 unidades de código Unicode. Desde entonces, la cifra se mantiene en 400 en las páginas de Microsoft citadas arriba. Si una guía antigua o una herramienta de migración todavía indica 256 o 260, describe el límite antiguo o el límite de Windows, no el límite actual de la nube.
Las columnas de hipervínculo tienen su propio límite de 255 caracteres
Un segundo límite se confunde a menudo con el de la ruta. En un hilo de Microsoft Q&A, una respuesta de soporte de Microsoft indica que la columna Hipervínculo de una lista o biblioteca de SharePoint tiene un límite de 255 caracteres, y que es así por diseño. Una estructura de carpetas profunda puede generar fácilmente un enlace más largo, porque el enlace a un archivo repite el nombre de cada carpeta.
La alternativa sugerida es una columna Texto de varias líneas con texto enriquecido mejorado, en la que el enlace se añade con la opción de hipervínculo del editor. Los comentaristas del hilo señalan dos inconvenientes: el enlace puede no actualizarse cuando el archivo de destino se renombra o se mueve, y la opción de texto enriquecido mejorado no está disponible en las bibliotecas de documentos. Los nombres de carpeta más cortos evitan el problema desde la raíz.
Los límites que afectan en Windows
Una ruta puede estar bien en SharePoint y aun así fallar en el escritorio. El mismo artículo de ayuda enumera el lado de Windows:
- Las aplicaciones de escritorio de Office no pueden abrir archivos cuya ruta completa supere los 260 caracteres, aunque el archivo esté almacenado en local.
- El Explorador de archivos usa el límite de 260 caracteres para abrir, renombrar y mover archivos. No usa la directiva de rutas largas de Windows.
- La sincronización de OneDrive permite una ruta local total de 520 caracteres: una ruta local de hasta 400 caracteres más una carpeta raíz de OneDrive de hasta 120 caracteres.
- Los nombres de archivos o carpetas individuales pueden tener hasta 255 caracteres en el Explorador de archivos y en el Finder de macOS.
La ruta local incluye la carpeta que contiene la biblioteca sincronizada, que es más larga de lo que la mayoría espera. Así, una ruta de 250 caracteres en la nube puede ser de 310 caracteres en el portátil de un usuario. Considera 260 como límite práctico para cualquier contenido que la gente abra desde carpetas sincronizadas.
Nombres que SharePoint rechaza
La longitud es solo la mitad de la lista de comprobación. El artículo de Microsoft Restrictions and limitations in OneDrive and SharePoint enumera qué debes revisar:
- Caracteres no válidos: comillas dobles, asterisco, dos puntos, menor que, mayor que, signo de interrogación, barra diagonal, barra invertida y barra vertical.
- Espacios: no se permiten espacios al principio ni al final.
- Nombres reservados: .lock, CON, PRN, AUX, NUL, COM0 a COM9, LPT0 a LPT9, _vti_ y desktop.ini.
- Prefijos y fragmentos: no se permite un nombre de archivo que empiece por
~$, y_vti_no puede aparecer en ningún punto del nombre. El nombreformsno está permitido en la raíz de una biblioteca. - Signo de número y signo de porcentaje: algunas organizaciones todavía no los admiten en los nombres. Los administradores globales y los administradores de SharePoint pueden habilitarlos.
Estas restricciones se aplican tanto a los archivos como a las carpetas. Una carpeta con un espacio al final bloquea todo lo que hay debajo, así que un solo nombre de carpeta incorrecto puede provocar miles de elementos fallidos.
Lista de comprobación previa a la migración
Sigue este orden en cada recurso compartido o sitio antes de copiar.
- Mide la longitud de las rutas en el origen. Exporta una lista de las rutas completas y calcula la longitud de cada una. En un recurso compartido de archivos,
Get-ChildItem -Recurseen PowerShell devuelve el nombre completo de cada elemento, y un script corto puede contar los caracteres. - Calcula la ruta de destino. Elimina la parte de la ruta de origen que no existe en la biblioteca y añade el nuevo prefijo relativo a la biblioteca. Cuenta desde
/sites, de modo que el nombre del sitio y el de la biblioteca de documentos forman parte del total. - Marca todo lo que supere los 300. El límite de 400 es el límite estricto. Un aviso a partir de 300 deja margen para la carpeta de sincronización y para los cambios de nombre posteriores.
- Enumera los caracteres no válidos y los nombres reservados. Busca los caracteres indicados arriba, los espacios al principio y al final, y nombres como los archivos
~$. - Corrige por orden de impacto. Acorta primero el nombre de la carpeta situada más arriba en un árbol largo. Un nombre de carpeta más corto acorta todas las rutas que hay debajo.
- Vuelve a medir. Repite el mismo recuento. Solo entonces planifica la copia.
Las herramientas de análisis de migración de Microsoft también ayudan. Migration Manager analiza cada archivo en busca de posibles problemas conocidos, y SharePoint Migration Tool ofrece una opción solo de análisis, para que puedas ver los problemas antes de mover nada. Úsalas como una segunda comprobación, no como la única.
Ejemplo: una ruta larga, dos límites
Este ejemplo usa nombres y cifras inventados. Un archivo está en un recurso compartido de archivos con una ruta de 247 caracteres por debajo de la raíz del recurso compartido, por ejemplo 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, seguida de un nombre de archivo de 107 caracteres. El destino es una biblioteca llamada Projects, y el ejemplo omite el nombre del sitio para simplificar las cifras: la biblioteca añade 9 caracteres por Projects/ y el total es 256.
- Límite de la nube: 256 está por debajo de 400, así que SharePoint acepta el archivo.
- Límite de Windows: una ruta sincronizada típica empieza con una carpeta local de 62 caracteres, como
C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. El total local es 62 + 247 = 309, que supera los 260. Las aplicaciones de escritorio de Office no pueden abrir el archivo desde la carpeta de sincronización.
La solución es acortar los nombres, no aumentar los límites. El responsable de la migración renombra las carpetas a Contracts, Northwind Phase 2, Tech Spec, Approved y Signed, y el archivo a Northwind Phase 2 - Tech Spec v3 signed.docx. La ruta por debajo de la raíz pasa de 247 a 103 caracteres. El total local pasa de 309 a 165, muy por debajo de 260 y dejando margen para un nombre de usuario más largo.
Revisa el aspecto empresarial antes de renombrar. Los contratos y las especificaciones técnicas suelen seguir normas de nomenclatura, y los nombres de archivo pueden tener que mantenerse idénticos por motivos legales. En ese caso, acorta las carpetas y conserva los nombres de archivo.
Opciones cuando una ruta es demasiado larga
Tienes cuatro opciones, en este orden de preferencia:
- Acorta los nombres de las carpetas. Es la forma más económica de acortar la URL, y beneficia a todos los archivos que hay debajo.
- Simplifica la estructura. Elimina los niveles que solo repiten información, como
Finaldentro deApproved. La guía de recursos compartidos de archivos de Microsoft también sugiere dividir las unidades grandes en bibliotecas más pequeñas y centradas en un tema. - Usa metadatos en lugar de carpetas. Una columna como Año o Cliente en la biblioteca sustituye a dos niveles de carpetas.
- Deja atrás el archivo. Si nadie lo ha abierto en años, archívalo en otro lugar.
No te fíes de una solución provisional, como mover el archivo un nivel hacia arriba después de la migración. Si no se corrige la causa, la siguiente reestructuración también fallará.
Acuerda las reglas con los propietarios del contenido antes de cambiar cualquier nombre. Una convención de nombres breve, por ejemplo no más de 40 caracteres por nombre de carpeta y no más de 8 niveles de carpetas, les da un objetivo y evita que el contenido nuevo vuelva a superar el límite después de la migración. Repítela en el anuncio de la migración para que la gente sepa por qué han cambiado los nombres de carpeta que conocía.
Errores comunes
- Contar desde el punto equivocado. La ruta del origen no es la ruta de la biblioteca. Calcula la ruta de destino.
- Olvidar la carpeta de sincronización local. Una ruta que funciona en el navegador puede fallar en las aplicaciones de escritorio de Office.
- Ignorar las reglas de cálculo. Las fuentes no coinciden en la codificación ni en el punto de partida, así que deja un margen. Una solicitud de migración que falla por un único elemento largo puede ocultar la causa real entre muchos errores similares.
- Corregir los nombres después de la copia. Los cambios de nombre en la nube se sincronizan con todos los clientes, y cambiar un nombre después del traslado repite trabajo que podrías haber hecho en el origen.
- Confiar en una única comprobación. Haz tu propia medición y ejecuta también el análisis de migración.
Cómo puede ayudar el software
PowerShell y una hoja de cálculo bastan para empezar: lista todas las rutas con su longitud, ordénalas por longitud y agrúpalas por carpeta de primer nivel. Los análisis de migración de Microsoft ofrecen una segunda perspectiva. Algunas herramientas de terceros también generan informes de rutas y nombres. Evalúa cualquier herramienta por si cuenta desde el punto de partida correcto y muestra los archivos y carpetas que bloquean la copia.
Siguiente paso
Exporta las rutas de un recurso compartido esta semana y ordénalas por longitud. Después anota cuántos archivos superan los 300 caracteres, porque ese número determina el esfuerzo de la limpieza para cumplir el límite de longitud de URL de SharePoint.