Cómo solucionar que el cliente de sincronización de Mac no pueda abrir archivos de SharePoint

Cuando usas el cliente de sincronización de OneDrive en un Mac, es posible que veas un error de que los archivos de SharePoint no se abren o que el cliente de sincronización no se inicia. Este problema suele ocurrir después de una actualización de macOS, un cambio en la configuración de red o una caché de sincronización dañada. La causa principal es un proceso de sincronización bloqueado, credenciales desactualizadas o una base de datos de sincronización local dañada. Este artículo explica por qué el cliente de sincronización no puede abrir archivos de SharePoint en Mac y proporciona soluciones paso a paso para restaurar el acceso normal a los archivos.

Por qué el cliente de sincronización de OneDrive en Mac no puede abrir archivos de SharePoint

El cliente de sincronización de OneDrive en macOS utiliza un proceso en segundo plano llamado OneDrive.app para sincronizar archivos entre tu máquina local y las bibliotecas de documentos de SharePoint. Cuando este proceso está bloqueado o sus datos se corrompen, los archivos aparecen como marcadores de posición o no se abren con un mensaje de error como “No se puede abrir el archivo” o “El archivo está bloqueado”. Tres causas comunes provocan este fallo:

Tokens de autenticación desactualizados o revocados

Microsoft 365 requiere una reautenticación periódica. Si tu token caduca o se revoca debido a un restablecimiento de contraseña o un cambio en la autenticación multifactor, el cliente de sincronización pierde el permiso para descargar o abrir archivos. El cliente puede seguir mostrando la lista de archivos, pero no puede recuperar el contenido real.

Base de datos de caché de sincronización dañada

El cliente de sincronización almacena metadatos y datos parciales de archivos en una base de datos local ubicada en ~/Library/Application Support/OneDrive. Después de una actualización de macOS o un apagado abrupto, esta base de datos puede dañarse. El cliente se bloquea o informa que los archivos no se pueden abrir, aunque los archivos existan en el servidor.

Restricciones de permisos del sistema en macOS

A partir de macOS Catalina, Apple requiere que las aplicaciones soliciten permiso explícito para acceder a ciertas carpetas. Si OneDrive no tiene Acceso Total al Disco o permiso de Archivos y Carpetas, no puede leer ni escribir en las carpetas de sincronización de SharePoint. El error aparece como un mensaje genérico de “no se puede abrir el archivo”.

Pasos para solucionar el cliente de sincronización de OneDrive en Mac

Realiza los siguientes pasos en orden. Prueba el acceso a los archivos después de cada paso para ver si el problema se resuelve.

1. Salir y reiniciar OneDrive
   Haz clic en el icono de nube de OneDrive en la barra de menú. Selecciona Salir de OneDrive. Espera 10 segundos y luego abre OneDrive desde la carpeta Aplicaciones. Esto limpia fallos temporales.
2. Desvincular y volver a vincular tu cuenta
   Haz clic en el icono de nube de OneDrive > Preferencias > Cuenta > Desvincular este Mac. Confirma la acción. Vuelve a iniciar sesión con tu cuenta de Microsoft 365 de trabajo o escuela. Esto fuerza un token de autenticación nuevo.
3. Limpiar la caché de sincronización
   Sal de OneDrive por completo. Abre Finder y presiona Comando+Mayús+G. Escribe ~/Library/Application Support/OneDrive y presiona Enter. Elimina todos los archivos y carpetas dentro de este directorio. No elimines la carpeta en sí. Reinicia OneDrive. El cliente reconstruirá la base de datos desde el servidor.
4. Otorgar a OneDrive Acceso Total al Disco
   Abre Preferencias del Sistema > Seguridad y Privacidad > pestaña Privacidad. Selecciona Acceso Total al Disco en el panel izquierdo. Haz clic en el icono de candado para realizar cambios. Haz clic en el botón más (+) y agrega OneDrive desde la carpeta Aplicaciones. Reinicia OneDrive.
5. Restablecer la aplicación OneDrive
   Si el problema persiste, restablece la aplicación. Sal de OneDrive. Abre Terminal desde Aplicaciones > Utilidades. Ejecuta este comando:
   killall OneDrive
   Luego ejecuta:
   ~/Library/Application Support/OneDrive/OneDrive.app/Contents/MacOS/OneDrive
   Esto inicia la aplicación en modo de restablecimiento. Sigue las instrucciones en pantalla para configurar la sincronización nuevamente.

Si OneDrive aún no puede abrir archivos de SharePoint después de la solución principal

Algunos problemas requieren pasos adicionales más allá del restablecimiento estándar. A continuación se muestran los patrones de fallo restantes más comunes y sus soluciones específicas.

Los archivos de SharePoint aparecen atenuados o no disponibles

Este síntoma generalmente significa que el cliente de sincronización está en un estado de pausa. Haz clic en el icono de nube de OneDrive y verifica si Pausar sincronización está activo. Si es así, haz clic en Reanudar sincronización. Si la opción no es visible, ve a Preferencias > Red y aumenta el límite de velocidad de subida y descarga al menos al 50% de tu ancho de banda.

La aplicación OneDrive no se inicia después de una actualización de macOS

Las actualizaciones de macOS a veces eliminan OneDrive de la lista de elementos de inicio de sesión. Abre Preferencias del Sistema > Usuarios y Grupos > Elementos de Inicio. Haz clic en el botón más y agrega OneDrive. Reinicia tu Mac. Esto asegura que el cliente de sincronización se inicie automáticamente y complete su inicialización.

Error de permiso denegado al abrir un archivo sincronizado

El archivo puede estar desprotegido por otro usuario o tener permisos de uso compartido restrictivos. Abre el archivo en un navegador navegando a la biblioteca de documentos de SharePoint. Verifica las propiedades del archivo para ver el estado de desprotección. Si está desprotegido, pide al usuario que lo vuelva a proteger. Si el archivo no está desprotegido, verifica que tengas al menos permisos de Colaborador en la biblioteca.

Cliente de sincronización de OneDrive vs acceso mediante navegador para archivos de SharePoint

Elemento	Cliente de sincronización de OneDrive	Navegador (SharePoint Online)
Método de acceso a archivos	Sistema de archivos local a través de Finder	URL del navegador web
Disponibilidad sin conexión	Archivos bajo demanda o copias descargadas	Ninguna a menos que el archivo se descargue manualmente
Comportamiento de bloqueo de archivos	El cliente de sincronización respeta el estado de desprotección	Se abre en el navegador como solo lectura si está bloqueado
Actualización de autenticación	Requiere volver a vincular después de que caduque el token	Utiliza cookies de sesión del navegador
Mejor para	Edición frecuente de muchos archivos	Visualización única o edición ocasional

Después de completar los pasos anteriores, deberías poder abrir archivos de SharePoint a través del cliente de sincronización de OneDrive en tu Mac. Si el problema continúa, usa el navegador como solución temporal mientras el Soporte de Microsoft investiga. Para problemas persistentes, ejecuta el comando Restablecer OneDrive en Terminal para forzar una reinicialización completa del motor de sincronización.