Cuando OneDrive no sincroniza un archivo, se bloquea inesperadamente o muestra un mensaje de error, el primer lugar donde buscar la causa raíz son los archivos de registro de OneDrive. Estos registros guardan cada operación de sincronización, conflicto y error que encuentra el cliente. En Windows, los registros se almacenan en una carpeta oculta dentro de su perfil de usuario. En Mac, los registros residen en el directorio Application Support. Este artículo explica exactamente dónde encontrar esos registros en cada sistema operativo, cómo abrirlos y cómo interpretar los códigos de error más comunes para resolver problemas de sincronización más rápido.
Puntos clave: cómo encontrar y leer los archivos de registro de OneDrive
- Windows: %localappdata%\Microsoft\OneDrive\logs\ Contiene los archivos SyncDiagnostics.log y DeviceManager.log que registran todos los eventos de sincronización y errores de registro de dispositivos.
- Mac: ~/Library/Application Support/OneDrive/logs/ Almacena los mismos archivos de registro en una carpeta Library oculta; use el menú Ir del Finder para acceder rápidamente.
- Código de error 0x8004de40: Indica un problema con el token de inicio de sesión; borrar las credenciales en caché en el Administrador de credenciales (Windows) o en Acceso a Llaveros (Mac) suele resolverlo.
Qué registran los archivos de registro de OneDrive y por qué los necesita
Los registros de OneDrive son archivos de texto sin formato que el cliente de sincronización escribe automáticamente durante cada sesión. Contienen marcas de tiempo, ID de operación, rutas de archivos, códigos de respuesta HTTP y descripciones de errores. A diferencia de los mensajes de error genéricos que se muestran en la bandeja del sistema, estos registros revelan el paso exacto en el que falló una sincronización, como un conflicto de bloqueo de archivo, un error de permisos o un tiempo de espera de red agotado.
Los dos archivos de registro principales son:
SyncDiagnostics.log
Este archivo registra cada intento de carga, descarga, cambio de nombre y eliminación de archivos. También registra los resultados de enumeración de carpetas del servidor. Si un archivo se queda atascado con el icono de sincronización pendiente, SyncDiagnostics.log mostrará la última solicitud y respuesta HTTP para ese archivo.
DeviceManager.log
Este archivo registra el registro de dispositivos, la actualización del token de autenticación y los eventos de aplicación de directivas del inquilino. Los errores en este archivo suelen indicar credenciales expiradas, acceso de dispositivo bloqueado o configuración incorrecta de directivas de grupo de OneDrive.
Ambos registros se rotan automáticamente cuando alcanzan aproximadamente 5 MB. Los archivos de registro más antiguos se comprimen en archivos .zip con un sufijo numérico, como SyncDiagnostics.1.log.zip. Puede abrir los archivos .log con cualquier editor de texto, incluido Notepad en Windows y TextEdit en Mac. Para los archivos .zip, extráigalos primero con las herramientas integradas del sistema operativo.
Pasos para acceder a los registros de OneDrive en Windows
- Abra el cuadro de diálogo Ejecutar
Presione Windows key + R en su teclado. Aparece el cuadro de diálogo Ejecutar. - Pegue la ruta de la carpeta de registros
Escriba%localappdata%\Microsoft\OneDrive\logs\en el campo Abrir y haga clic en Aceptar. El Explorador de archivos se abre directamente en la carpeta de registros. - Ordene los archivos por fecha de modificación
Haga clic en el encabezado de la columna Fecha de modificación para ordenar los archivos más recientes en la parte superior. Las entradas de registro más recientes están en el archivo con el sufijo numérico más alto, por ejemplo SyncDiagnostics.5.log. - Abra el archivo de registro
Haga doble clic en SyncDiagnostics.log o en la variante numerada más reciente. Si Windows le pide que elija un programa, seleccione Notepad. - Busque códigos de error
Presione Ctrl + F y escriba el código de error o el nombre del archivo que está fallando. Busque líneas que contengan “Error”, “Failed” o “Conflict”. Cada línea comienza con una marca de tiempo en el formato YYYY-MM-DDTHH:MM:SS.
Si no puede ver la carpeta de registros, asegúrese de que los elementos ocultos estén visibles. En el Explorador de archivos, haga clic en Ver > Mostrar > Elementos ocultos. La carpeta AppData está oculta de forma predeterminada en Windows.
Pasos para acceder a los registros de OneDrive en Mac
- Abra Finder
Haga clic en el icono de Finder en el Dock. - Vaya a la carpeta Library
En la barra de menús del Finder, haga clic en Ir > Ir a la carpeta. Aparece un campo de texto. - Pegue la ruta de la carpeta de registros
Escriba~/Library/Application Support/OneDrive/logs/y presione Return. Se abre una ventana del Finder que muestra la carpeta de registros. - Ordene los archivos por fecha de incorporación
Haga clic en la columna Fecha de incorporación o Fecha de modificación para colocar los archivos más recientes en la parte superior. En Mac, el archivo de registro activo normalmente se llama SyncDiagnostics.log. - Abra el archivo de registro
Haga doble clic en SyncDiagnostics.log. Se abre en Console de forma predeterminada. Para verlo como texto sin formato, haga clic derecho en el archivo, elija Abrir con y seleccione TextEdit. - Busque códigos de error
Presione Command + F y escriba el código de error o el nombre del archivo. Console resalta las líneas coincidentes en amarillo.
Si la carpeta Library está oculta, mantenga presionada la tecla Option mientras hace clic en el menú Ir del Finder. La opción Library aparece directamente en el menú Ir sin necesidad de escribir la ruta.
Cómo leer las entradas del registro de OneDrive
Cada entrada del registro sigue una estructura coherente. Una línea típica se ve así:
2025-03-28T14:32:15.123Z [0x1A2B] [Info] Upload of file 'C:\Users\Name\OneDrive\report.xlsx' completed successfully (HTTP 200)
Las partes son:
Marca de tiempo
La fecha y hora en hora universal coordinada (UTC). Conviértala a su zona horaria local restando o sumando horas.
ID de subproceso
El número hexadecimal entre corchetes, por ejemplo [0x1A2B]. Identifica qué subproceso en segundo plano procesó la operación. Puede ignorarlo a menos que esté rastreando una operación específica en varias líneas.
Nivel de gravedad
Uno de Info, Warning, Error o Critical. Concéntrese primero en las líneas Error y Critical. Las líneas Warning indican problemas recuperables, como un fallo temporal de red.
Mensaje
La descripción del evento. Los mensajes comunes incluyen “Upload of file”, “Download of file”, “Conflict detected”, “Token refresh failed” y “Server returned HTTP 409”.
Código de estado HTTP
Números como 200 (éxito), 403 (prohibido), 404 (no encontrado), 409 (conflicto), 423 (bloqueado), 429 (demasiadas solicitudes) y 500 (error del servidor). Un código 409 generalmente significa que el archivo se modificó en el servidor mientras había un cambio local en curso.
Errores comunes en los registros de OneDrive y su significado
0x8004de40 — Error al actualizar el token
Este error aparece en DeviceManager.log cuando OneDrive no puede renovar su token de autenticación. La causa suele ser una credencial en caché que ha expirado o un cambio de contraseña que no se sincronizó. Para solucionarlo, abra el Administrador de credenciales en Windows o Acceso a Llaveros en Mac, busque todas las entradas que contengan “OneDrive” o “MicrosoftAccount”, elimínelas y vuelva a iniciar sesión en OneDrive.
HTTP 409 — Conflicto de archivo detectado
Un código de estado 409 en SyncDiagnostics.log significa que el archivo se modificó tanto localmente como en el servidor al mismo tiempo. OneDrive crea una copia en conflicto con el nombre del equipo agregado al nombre del archivo. Abra ambas versiones y combine los cambios manualmente, luego elimine la copia en conflicto.
0x8007016a — El proveedor de archivos en la nube no está en ejecución
Este error indica que el controlador Windows Cloud Files Filter está deshabilitado o se bloqueó. Reinicie el proceso de OneDrive haciendo clic derecho en el icono de OneDrive en la bandeja del sistema y seleccionando Cerrar OneDrive, luego inicie OneDrive de nuevo desde el menú Inicio. Si el error persiste, ejecute sfc /scannow en un símbolo del sistema elevado para reparar los archivos del sistema.
HTTP 423 — El archivo está bloqueado por otro proceso
Un código de estado 423 significa que el archivo está abierto en otra aplicación, como Microsoft Excel o un lector de PDF. Cierre la aplicación que mantiene el bloqueo y espere a que OneDrive reintente la sincronización. Para forzar un reintento inmediato, haga clic derecho en el archivo en el Explorador de archivos y seleccione Sincronizar.
SyncDiagnostics.log vs DeviceManager.log: qué cubre cada registro
| Elemento | SyncDiagnostics.log | DeviceManager.log |
|---|---|---|
| Eventos registrados | Cargas, descargas, eliminaciones, cambios de nombre y conflictos de archivos | Registro de dispositivos, actualización de tokens, aplicación de directivas y eventos de inicio de sesión |
| Códigos de error típicos | HTTP 200, 403, 404, 409, 423, 429, 500 | 0x8004de40, 0x8004de44, 0x8004de4c |
| Cuándo revisar | Un archivo específico no se sincroniza o muestra un icono pendiente | OneDrive no puede iniciarse, muestra el aviso de inicio de sesión repetidamente o informa un error de licencia |
| Límite de tamaño de archivo | 5 MB por archivo, luego se rota y comprime | 5 MB por archivo, luego se rota y comprime |
Si está solucionando un fallo de inicio de sesión o un bloqueo de dispositivo, abra DeviceManager.log primero. Si está solucionando un archivo que no se carga ni se descarga, abra SyncDiagnostics.log primero.
Si los registros de OneDrive están vacíos o faltan
Una carpeta de registros vacía o un archivo de registro con solo una línea de encabezado generalmente significa que OneDrive no estuvo en ejecución el tiempo suficiente para escribir entradas, o que la rotación de registros eliminó los archivos antiguos. Inicie OneDrive, realice la acción que desencadena el error y luego revise los registros de nuevo inmediatamente. Si la carpeta no existe en absoluto, es posible que OneDrive no esté instalado correctamente. Reinstale OneDrive desde el portal de Microsoft 365 y reinicie su equipo.
En Windows, si falta la carpeta de registros pero OneDrive está en ejecución, es posible que el perfil de usuario esté dañado. Cree un nuevo perfil de usuario de Windows e inicie sesión en OneDrive allí. En Mac, asegúrese de que OneDrive tenga permisos de acceso al disco en Configuración del sistema > Privacidad y seguridad > Archivos y carpetas.
Ahora puede localizar, abrir y leer los archivos de registro de OneDrive en Windows y Mac sin depender de mensajes de error genéricos. La próxima vez que falle una sincronización, revise SyncDiagnostics.log para códigos HTTP 409 o 423, y revise DeviceManager.log para errores de token como 0x8004de40. Para solucionar problemas más rápido, mantenga abierto un editor de texto con el archivo de registro cargado para poder actualizarlo después de cada intento de sincronización.