Separar errores de permisos de errores de sincronización: configuración paso a paso

Cuando trabaja con bibliotecas de documentos de SharePoint, es posible que vea errores que detienen la sincronización de archivos. Algunos errores provienen de la configuración de permisos, mientras que otros provienen del propio motor de sincronización. Estos dos tipos de errores se ven similares, pero requieren soluciones diferentes. Este artículo muestra cómo distinguirlos y configurar su sistema para evitar confusiones.

Por qué los errores de permisos y los errores de sincronización se ven iguales

La sincronización de SharePoint y OneDrive usa la misma aplicación cliente. Cuando un archivo no se sincroniza, el cliente muestra un mensaje de error genérico. El mensaje suele decir “No tiene permiso para sincronizar esta carpeta” o “Algo salió mal”. Estos mensajes no le indican la causa raíz.

Los errores de permisos ocurren cuando el usuario no tiene acceso de lectura o escritura a un sitio, biblioteca o carpeta de SharePoint. Los errores de sincronización ocurren cuando el motor de sincronización de OneDrive no puede descargar o cargar un archivo debido a un conflicto, un archivo bloqueado o una caché dañada. El cliente de sincronización trata ambos casos como un fallo y muestra el mismo icono de estado.

Para solucionar el problema correcto, debe separar ambos casos. El cliente de sincronización puede informar un error de permisos incluso cuando el usuario tiene acceso completo. Este informe erróneo ocurre cuando el motor de sincronización pierde su token de autenticación o cuando otro usuario tiene el archivo extraído. De forma similar, un error de permisos real puede aparecer como un error de sincronización si el cliente de sincronización no puede leer correctamente los permisos del sitio.

Pasos para configurar la separación de errores

Siga estos pasos para configurar su entorno de SharePoint y OneDrive de modo que los errores de permisos y los errores de sincronización aparezcan en lugares distintos. Esta configuración usa el centro de administración de SharePoint, la configuración de sincronización de OneDrive y el Visor de eventos de Windows.

Paso 1: Habilitar el registro detallado de sincronización

1. Abrir la configuración de OneDrive
   Haga clic con el botón derecho en el icono de la nube de OneDrive en la bandeja del sistema y seleccione Configuración. Vaya a la pestaña Sincronización y copia de seguridad.
2. Activar el registro detallado
   En la sección Avanzado, marque la casilla “Recopilar registros automáticamente”. Esta configuración hace que el cliente de sincronización escriba códigos de error detallados en el archivo de registro en lugar de mensajes genéricos.
3. Reiniciar OneDrive
   Haga clic en Aceptar y, a continuación, haga clic con el botón derecho en el icono de OneDrive y seleccione Cerrar OneDrive. Abra OneDrive de nuevo desde el menú Inicio. El nuevo nivel de registro surte efecto de inmediato.

Paso 2: Configurar alertas de permisos de SharePoint

1. Abrir el centro de administración de SharePoint
   Vaya a https://admin.microsoft.com/Sharepoint. Inicie sesión como administrador de SharePoint.
2. Ir a Directivas > Uso compartido
   En el panel de navegación izquierdo, seleccione Directivas y, a continuación, Uso compartido. En Uso compartido externo, establezca el nivel de permisos para cada sitio. Este paso no corrige errores, pero garantiza que los cambios de permisos se registren en el registro de auditoría.
3. Habilitar el registro de auditoría para cambios de permisos
   En el centro de administración de SharePoint, vaya a Informes > Registro de auditoría. Active el registro de auditoría si está desactivado. Los cambios de permisos ahora aparecen en el registro de auditoría con un ID de evento independiente.

Paso 3: Usar el Visor de eventos de Windows para filtrar errores

1. Abrir el Visor de eventos
   Presione la tecla Windows + R, escriba eventvwr.msc y presione Entrar.
2. Ir a los registros de OneDrive
   Expanda Registros de aplicaciones y servicios > Microsoft > Windows > OneDrive Sync. Seleccione Operativo.
3. Filtrar por códigos de error
   En el panel derecho, haga clic en Filtrar registro actual. En el campo Id. de evento, escriba 1001 para errores de permisos y 1003 para errores de sincronización. Haga clic en Aceptar. El registro ahora muestra solo el tipo de error que desea ver.

Paso 4: Configurar canales de notificación separados

1. Crear una alerta de SharePoint para cambios de permisos
   En un sitio de SharePoint, vaya a la biblioteca, haga clic en los puntos suspensivos (tres puntos) y seleccione Alertarme. Configure la alerta para que le notifique cuando alguien cambie los permisos. Esta alerta llega a su correo electrónico, de forma separada de las notificaciones de errores de sincronización.
2. Desactivar las notificaciones emergentes de OneDrive para errores de sincronización
   En Configuración de OneDrive > Sincronización y copia de seguridad > Avanzado, desmarque “Mostrar notificaciones de sincronización”. Los errores de sincronización seguirán apareciendo en el registro, pero no generarán mensajes emergentes que parezcan errores de permisos.

Si los errores de permisos siguen apareciendo como errores de sincronización después de la configuración

OneDrive informa “Acceso denegado” pero el usuario tiene permisos completos

Esta situación ocurre cuando el token de autenticación del usuario ha expirado. El cliente de sincronización intenta acceder al sitio de SharePoint, pero el token no es válido. El cliente muestra “Acceso denegado” aunque el usuario siga teniendo permisos. Para solucionarlo, cierre la sesión de OneDrive y vuelva a iniciarla. Haga clic con el botón derecho en el icono de OneDrive, seleccione Configuración > Cuenta > Desvincular este equipo. A continuación, vuelva a iniciar sesión con la misma cuenta profesional o educativa.

El error de sincronización indica “Archivo en uso” pero nadie tiene el archivo abierto

Este error puede ocurrir cuando una sincronización anterior dejó un bloqueo en el archivo. El bloqueo persiste incluso después de que el usuario cierre el archivo. El cliente de sincronización informa un error de sincronización, pero el problema real es un bloqueo obsoleto. Para resolverlo, use el centro de administración de SharePoint para forzar una inserción. Vaya a la biblioteca de documentos, seleccione el archivo y elija Insertar en el menú. Si no aparece la opción de inserción, el archivo no está extraído. En ese caso, borre la caché de sincronización deteniendo la sincronización y eliminando la carpeta local.

Aparece un error de permisos después de una migración de sitio

Cuando un sitio de SharePoint se mueve a otra región o se le cambia el nombre, el cliente de sincronización puede seguir usando la URL anterior. La URL anterior ya no tiene los permisos del usuario, por lo que el cliente muestra un error de permisos. Para solucionarlo, quite el sitio de la sincronización de OneDrive y vuelva a agregarlo usando la nueva URL. Vaya a Configuración de OneDrive > Cuenta > Elegir carpetas. Haga clic en Dejar de sincronizar para la biblioteca afectada y, a continuación, haga clic en Sincronizar archivos y seleccione la misma biblioteca desde el nuevo sitio.

Error de permisos frente a error de sincronización: diferencias clave

Elemento	Error de permisos	Error de sincronización
Mensaje de error típico	“No tiene acceso a esta carpeta”	“Algo salió mal durante la sincronización”
ID del Visor de eventos	1001	1003
Causa raíz	El usuario carece de permiso de lectura o escritura en el sitio o la biblioteca de SharePoint	Conflicto de archivos, bloqueo de archivo, caché dañada o problema de red temporal
Solución típica	Agregar el usuario a los permisos del sitio o la biblioteca de SharePoint	Borrar la caché de sincronización o insertar el archivo
Canal de notificación	Alerta de SharePoint (correo electrónico) o centro de administración	Icono de estado de sincronización de OneDrive o archivo de registro

Conclusión

Ahora puede identificar errores de permisos y errores de sincronización consultando el filtro del Visor de eventos y el archivo de registro de OneDrive. Los pasos de configuración de este artículo le permiten ver cada tipo de error en una vista separada. Comience habilitando el registro detallado en OneDrive y creando una alerta de SharePoint para cambios de permisos. Use el Visor de eventos con los ID de evento 1001 y 1003 para aislar la causa raíz. Si sigue viendo errores mezclados, compruebe el token de autenticación cerrando y volviendo a iniciar sesión en OneDrive.