OneDrive Sync Errors — Missing Files, Duplicate Conflict Copies, and Stuck Uploads (Windows / macOS)

Indicators

• Red X or yellow warning badge on OneDrive system tray icon — sync paused or errored
• Files visible on OneDrive web portal but absent from the local sync folder, or vice versa
• Duplicate files with conflict suffixes such as '-John's MacBook' or '(1)' appended to the filename
• Upload progress bar stuck at a fixed percentage for an extended period with no completion
• OneDrive activity centre shows persistent list of files with 'Upload failed' or 'Can't sync this file' messages
• Files stuck in 'Syncing' state that never complete after several minutes
• Error notifications referencing specific file or folder names that cannot be synced

Likely causes

• Invalid characters (* " : < > ? / \ |) or reserved Windows names (CON, PRN, AUX, NUL, COM1–COM9, LPT1–LPT9) in file or folder paths, or paths exceeding 400 characters — blocked by SharePoint naming rules
• OneDrive account authentication token expiry or corruption — user must sign in again
• Local OneDrive client cache or sync database corruption — engine enters inconsistent state
• Storage quota exhausted on the user's OneDrive — prevents any new uploads
• Corporate proxy, firewall, or SSL inspection breaking OneDrive HTTPS connections to Microsoft endpoints
• Simultaneous editing of the same file from multiple devices or sessions — generates conflict copies
• Outdated OneDrive sync client version with known sync bugs
• SharePoint library limits (too many items, IRM-protected files, site collection size limits)
• File locked by another process (e.g., open in Word or Excel) — prevents upload completion
• Known Folder Move (Desktop/Documents/Pictures) misconfiguration or permission conflicts

Diagnostic steps

1. Click the OneDrive system tray icon and open the activity centre. Review each file-level error message. Note exact error text, filenames flagged, and whether the issue is account-wide or isolated to specific files.
   Determines whether the failure is file-specific (naming/size/type) or affects the entire sync relationship (auth, network, or client corruption) — directs which fix path to follow.
2. Verify OneDrive storage quota: navigate to https://onedrive.live.com (personal) or Microsoft 365 portal > OneDrive settings > Storage. Confirm the account is not at or near its quota limit.
   Rules out storage exhaustion, which presents identically to other sync failures but requires a completely different remediation.
3. Inspect flagged file and folder names for naming violations: invalid characters (* " : < > ? / \ |), reserved Windows names (CON, PRN, AUX, NUL, COM1–COM9, LPT1–LPT9), leading/trailing spaces or periods, and total path length exceeding 400 characters.
   Identifies whether specific files are blocked by SharePoint/OneDrive naming restrictions — must be renamed before sync can proceed.
4. Verify account sign-in: right-click the OneDrive tray icon > Settings > Account tab. Confirm the signed-in account email matches the expected account. Check for a warning icon indicating an authentication error.
   Confirms whether an expired or corrupt authentication token or an account mismatch is causing the sync failure.
5. Review OneDrive sync diagnostic logs: right-click the OneDrive tray icon, hold Ctrl, click 'Get diagnostics' (Windows) to open the SaRA log bundle, or manually inspect %localappdata%\Microsoft\OneDrive\logs\SyncDiagnostics.log and the latest *.odl log files.
   Provides detailed error codes and event sequences from the sync engine to pinpoint the exact failure mode.
6. Test network connectivity to OneDrive service endpoints in PowerShell: Personal: `Test-NetConnection -ComputerName onedrive.live.com -Port 443` Business: `Test-NetConnection -ComputerName <tenant>-my.sharepoint.com -Port 443` Also confirm no proxy or SSL inspection is intercepting the connection.
   Determines whether network or proxy interference is preventing the sync client from reaching Microsoft's servers.
7. Check whether stuck-uploading files are locked by another process: open Task Manager (Ctrl+Shift+Esc) > Resource Monitor > CPU tab > Associated Handles, search for the filename to identify the locking process. Alternatively, use Process Explorer (Sysinternals) Find Handle.
   Identifies file locks held by Office applications or other processes that prevent OneDrive from completing the upload.

Resolution path

• 1. RENAME INVALID FILES/FOLDERS: For files flagged with naming errors, rename to remove invalid characters (* " : < > ? / \ |), reserved names (CON, PRN, AUX, NUL, COM1–COM9, LPT1–LPT9), leading/trailing spaces or periods, and shorten any paths exceeding 400 characters. Use File Explorer or a bulk-rename tool. OneDrive retries the upload automatically after rename.
• 2. FREE UP STORAGE QUOTA: If the account is over quota, delete unnecessary files via the OneDrive web portal, empty the recycle bin (web portal > Recycle bin > Empty recycle bin), or purchase additional storage. Sync resumes automatically once space is available.
• 3. SIGN OUT AND RE-LINK ACCOUNT: Right-click the OneDrive tray icon > Settings > Account > Unlink this PC. Follow the setup wizard to sign in again. Choose the same local sync folder to resume without re-downloading everything if local files are intact.
• 4. RESET THE ONEDRIVE CLIENT (Windows): Open Run (Win+R) and execute: `%localappdata%\Microsoft\OneDrive\onedrive.exe /reset`. Wait 2 minutes; if the tray icon does not reappear, run: `%localappdata%\Microsoft\OneDrive\onedrive.exe` to restart the client. This clears the local sync database and forces a full rescan. Do NOT delete local files before confirming the cloud copy is complete.
• 5. RESOLVE DUPLICATE/CONFLICT FILES: Search the OneDrive sync folder in File Explorer for conflict-named files (filenames with computer name suffixes or '(1)' appended). Compare conflict copies with originals, merge or discard as appropriate, then delete the unwanted copy. The retained file syncs to the cloud.
• 6. RELEASE LOCKED FILES FOR STUCK UPLOADS: For files stuck uploading, close the application holding the file lock (e.g., Word, Excel). Save and close the document to release the lock, allowing OneDrive to complete the upload.
• 7. UPDATE THE ONEDRIVE CLIENT: Open OneDrive settings > About tab and verify the build number against the current release at https://support.microsoft.com/en-us/office/onedrive-release-notes-845dcf18-f921-435e-bf28-4e24b95e5fc0. Update via Microsoft Update or download the latest installer from https://onedrive.live.com/about/en-us/download/. Restart the client after updating.
• 8. RECOVER MISSING FILES FROM RECYCLE BIN: If files are missing from both the local folder and the cloud, open the OneDrive web portal Recycle Bin (items retained up to 93 days for business accounts). Select deleted files and click Restore. For business accounts, also check the site collection recycle bin (second-stage) if files are absent from the personal recycle bin.

Prevention

• Enforce OneDrive file naming compliance by educating users on invalid characters and the 400-character path limit; deploy a Group Policy or Microsoft 365 sensitivity label policy to warn users before saving non-compliant filenames.
• Enable automatic OneDrive client updates via Microsoft Update or Intune to ensure users always run a supported build with the latest sync engine fixes.
• Monitor storage quota proactively via Microsoft 365 admin centre alerts or PowerShell reporting; configure quota warning thresholds so users are notified before uploads begin failing.
• Configure Known Folder Move (Desktop, Documents, Pictures) via Group Policy or Intune only after verifying no existing folder redirection conflicts — test on a pilot group before broad deployment.
• Advise users to close Office files before shutting down or moving between networks to avoid leaving files in a locked state that blocks upload completion.

Tools

• OneDrive sync client system tray — primary interface for status, settings, and activity centre
• OneDrive web portal (https://onedrive.live.com or SharePoint URL) — cloud-side file verification and recycle bin
• Microsoft Support and Recovery Assistant (SaRA) — automated OneDrive diagnostics and repair
• File Explorer search — locating conflict or duplicate files by name pattern
• PowerShell Test-NetConnection — verifying TCP connectivity to OneDrive endpoints on port 443
• OneDrive diagnostic logs at %localappdata%\Microsoft\OneDrive\logs\ — detailed sync engine event review (SyncDiagnostics.log, *.odl)
• Task Manager / Resource Monitor — identifying processes locking files and blocking upload

References

• Fix OneDrive sync problems — Microsoft Support
• Invalid file names and file types in OneDrive and SharePoint
• Restore deleted files or folders in OneDrive
• OneDrive release notes (current build versions)