OneDrive for Business shared library sync troubleshooting for slow networks: loops after restart

When you restart OneDrive after a network interruption, a shared library may enter a sync loop that never completes. This loop appears as a continuous “Processing changes” or “Syncing” status that stalls for hours. The root cause is a mismatch between the local sync database and the server state, triggered by slow network responses during the initial sync handshake. This article explains why the loop occurs on slow networks and provides step-by-step fixes to break the cycle and restore reliable sync.

Why Shared Library Sync Loops After Restart on Slow Networks

OneDrive for Business uses a local sync database to track file changes. When you restart OneDrive, it performs a full reconciliation between the local database and the server. On a slow network, the handshake packets can time out or arrive out of order. OneDrive then marks the library as out of sync and retries the reconciliation from the beginning. This creates a loop where the client repeatedly downloads the same file metadata and never reaches the “Up to date” state.

The loop is more common with shared libraries that contain many files or deep folder structures. Each file requires a separate metadata request. On a connection with high latency or packet loss, the requests queue up and eventually exceed OneDrive’s internal timeout threshold. The client then aborts the current sync pass and starts over, which perpetuates the loop.

How the Loop Manifests

You see the OneDrive icon cycling in the system tray. The tooltip shows “Processing changes” or “Syncing” with no progress. In the OneDrive activity center, the shared library shows a status of “Sync pending” or “Changes pending” for hours. The local folder may contain placeholder files that never download their content.

Steps to Break the Shared Library Sync Loop

These steps stop the loop and force a clean sync. Perform them in order. Test after each step to see if the issue resolves.

Method 1: Stop Sync on the Problematic Shared Library

1. Open OneDrive settings
   Right-click the OneDrive cloud icon in the system tray and select Settings. Go to the Account tab.
2. Stop sync on the shared library
   Under Manage Storage, locate the shared library that is looping. Click Stop sync. Confirm the action. This removes the library from the local sync database but leaves the files on the server untouched.
3. Restart OneDrive
   Right-click the OneDrive icon and select Exit. Open OneDrive again from the Start menu. The library will no longer appear in File Explorer.
4. Re-add the shared library
   In OneDrive settings under the Account tab, click Add a shared library. Select the library from the list and click Sync now. This initiates a fresh sync with a clean database.

Method 2: Reset OneDrive Sync Cache

1. Open Command Prompt as administrator
   Press the Windows key, type cmd, right-click Command Prompt, and select Run as administrator.
2. Run the reset command
   Type the following command and press Enter:
   onedrive.exe /reset
   This stops OneDrive and clears the local sync database. Your files remain on the server and in the local OneDrive folder.
3. Restart OneDrive
   Open OneDrive from the Start menu. It will re-sync all libraries from scratch. The shared library loop should not recur because the corrupted database has been removed.

Method 3: Toggle Files On-Demand

1. Open OneDrive settings
   Right-click the OneDrive icon and select Settings.
2. Go to Advanced settings
   Click the Sync and backup tab and then Advanced settings.
3. Turn off Files On-Demand
   Under Files On-Demand, uncheck Save space and download files as you use them. Click OK. OneDrive will download all files from the shared library. This forces a full file-level sync.
4. Turn on Files On-Demand again
   After all files finish downloading, go back to the same setting and re-check the box. This rebuilds the placeholder database and often breaks the loop.

If the Shared Library Still Loops After the Main Fix

OneDrive Shows Error Code 0x8007016A on Shared Library Files

This error indicates that the local file path is too long or the file name contains unsupported characters. On a slow network, the sync engine may fail to process deep paths and retry indefinitely. To fix this, move the OneDrive folder to a shorter path. In OneDrive settings, go to Account and click Unlink this PC. During re-setup, choose a folder path with fewer characters, such as C:\OneDrive. Then re-add the shared library.

Shared Library Sync Stops at a Specific Percentage

If the sync loop stops at the same percentage each time, a single file is causing the failure. Open the shared library in the browser and check for files with special characters or unusually large sizes. Rename or remove the problematic file on the server. Then perform the reset command from Method 2 to clear the stuck state.

Network Throttling Causes the Loop to Return After Fix

If the loop returns after a few hours, the network connection is too slow for the default sync rate. In OneDrive settings under Sync and backup > Advanced settings, enable Limit download rate and set it to a value below your available bandwidth, such as 512 Kbps. This prevents OneDrive from flooding the connection and timing out.

Files On-Demand vs Always Keep on This Device: Key Differences for Slow Networks

Item	Files On-Demand	Always Keep on This Device
Description	Placeholders download content only when opened	Full file content is always stored locally
Impact on sync loop	More likely to loop on slow networks due to frequent metadata requests	Less likely to loop after initial full download
Bandwidth usage	Lower average usage, but bursts when opening files	High initial usage for full download, then minimal
Recommended for slow networks	Only after loop is broken and rate limiting is enabled	Preferred for stable long-term sync

After breaking the loop, you can stop sync on the shared library and re-add it with Files On-Demand disabled. This forces a full download and prevents the metadata request pattern that triggers the loop.

You can now identify and break a shared library sync loop caused by slow network conditions. Start by stopping sync on the specific library or running the onedrive.exe /reset command. If the loop recurs, enable download rate limiting in the advanced settings to match your connection speed. For persistent issues, disable Files On-Demand on the shared library and perform a full sync once. This approach eliminates the metadata request bottleneck that drives the loop.