跳至主要内容

修復 OneDrive 429 限流錯誤 — 使用 RcloneView 實現可靠同步

· 閱讀時間約 6 分鐘
Steve
Senior Engineer

當 OneDrive 在同步過程中開始回傳 429 Too Many Requests 時,解決辦法不是盲目重試,而是放慢你對 Microsoft Graph API 的請求力道。

OneDrive 對 Microsoft Graph API 施加了請求速率限制,一項搬移數千個小檔案的同步工作,或與其他多項工作同時執行的工作,很容易觸發這些限制,導致傳輸中途停滯或以 429 回應失敗。這與配額或儲存空間已滿的錯誤不同 —— 帳戶仍有空間,只是因為請求送達得太快,Microsoft 才會暫時拒絕請求。RcloneView 讓你能直接控制傳輸並行數與重試行為,因此你可以調整 OneDrive 工作,使其維持在門檻之下,而不是持續猛敲 API 導致失敗。

RcloneView 應用程式預覽

在同一處管理與同步所有雲端

RcloneView 是 rclone 的跨平台 GUI。透過清爽的視覺化介面比較資料夾、傳輸或同步檔案,並自動化多雲工作流程。

  • 一鍵作業:複製 · 同步 · 比較
  • 排程器與歷史記錄,打造可靠的自動化
  • 支援 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
WindowsmacOSLinux
免費開始使用 →

核心功能免費。Plus 提供自動化功能。

辨識 429 限流錯誤

查看底部 Info View 中的 Log 分頁,尋找 OneDrive 工作期間出現的 HTTP 429 回應或提及速率限制的訊息 —— 這與身分驗證失敗或「配額已用盡」訊息不同,後者分別指向權杖過期或帳戶已滿。限流錯誤通常會在大型工作進行到一半時成批出現,常見於同時傳輸大量小檔案而非少量大檔案的情況。若工作在經過幾次帶有間隔的重試後最終完成,這就是一個強烈訊號,顯示內建的重試邏輯已經在自行從限流中復原。

Job history log showing a OneDrive sync job with retries

降低並行數以減少限流

最直接的解決方法,是減少 RcloneView 一次向 OneDrive 送出的請求數量。在同步工作的 Advanced Settings 步驟中,降低檔案傳輸數與相等性檢查器(equality checker)數量 —— 規格建議對限流較積極的後端將相等性檢查器設為 4 或更少,而 OneDrive 正是其中之一。多執行緒傳輸也可以從預設值 4 降低,或設為 0 完全停用,這會以犧牲部分原始輸送量為代價,換取一項不會觸發速率限制而順利完成的工作。

Configuring transfer settings for a OneDrive sync job

讓重試機制發揮作用

RcloneView 的同步工作包含一項「Retry entire sync if fails」(失敗時重試整個同步)設定,預設為 3 次嘗試,這通常足以撐過一次暫時的限流視窗,因為 OneDrive 的速率限制會在短暫的冷卻期後重設。對於搬移大量檔案的 OneDrive 工作,請避免將此值設為 1(停用重試),否則單一次 429 回應就會讓整項工作失敗,而不會自動重試。RcloneView 可以在同一個視窗中跨 Windows、macOS 與 Linux 掛載並同步 90+ 服務商,因此若 OneDrive 只是你工作流程中眾多遠端之一,你可以將工作分散到不同服務商,避免請求集中在最容易限流的那個後端上。

Scheduling a OneDrive sync job to run at off-peak times

錯開排程工作的時間

若你按排程執行 OneDrive 同步工作,請避免在完全相同的時間觸發多項 OneDrive 工作 —— 即使針對不同資料夾,它們仍共用同一帳戶的速率限制。PLUS 授權使用者可以將 crontab 格式的排程錯開幾分鐘,以避免請求堆疊,並可在儲存前用排程模擬器預覽即將到來的執行時間。對於非常大型的一次性傳輸,在離峰時段執行工作,也有助於降低與同一 Microsoft 帳戶上其他自動化流量發生衝突的機率。

快速上手

  1. 若尚未下載,請從 rcloneview.com 下載 RcloneView
  2. 開啟出現 429 錯誤的 OneDrive 工作,在 Log 分頁中檢視失敗模式。
  3. 在 Advanced Settings 中降低檔案傳輸數與相等性檢查器數量,並確認重試次數設為至少 3 次。
  4. 重新執行工作,並觀察 Transferring 分頁以確認它能順利完成而不中斷。

一項緩慢但穩定完成的同步,勝過一項中途失敗、讓你摸不清究竟傳輸了什麼的快速同步。


相關指南:

支援的雲端服務商

Local Files
WebDAV
FTP
SFTP
HTTP
SMB / CIFS
Google Drive
Google Photos
Google Cloud Storage
OneDrive
Dropbox
Box
MS Azure Blob
MS File Storage
S3 Compatible
Amazon S3
pCloud
Wasabi
Mega
Backblaze B2
Cloudflare R2
Alibaba OSS
Ceph
Swift (OpenStack)
IBM Cloud Object Storage
Oracle Cloud Object Storage
IDrive e2
MinIO
Storj
DigitalOcean Spaces