跳至主要内容

修正 Dropbox 速率限制 API 錯誤 — 使用 RcloneView 解決傳輸問題

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

Dropbox 會強制執行 API 速率限制,在大量傳輸期間會導致 429 錯誤 — 在 RcloneView 中調整並行數與重試設定可以可靠地解決這個問題。

當同步大量檔案至 Dropbox 或從 Dropbox 同步時,您可能會遇到 too_many_requests、HTTP 429 或 dropbox: too many requests - retry after X seconds 等錯誤。這些是來自 Dropbox 的 API 速率限制回應,而非連線失敗。解決方法包括減少 RcloneView 同時發送的請求數量、設定重試行為,以及了解哪些操作會觸發 Dropbox 的限制。

RcloneView 應用程式預覽

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

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

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

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

在日誌中識別錯誤

當 Dropbox 速率限制發生時,錯誤會出現在工作執行期間或完成後 RcloneView 的日誌 (Log) 分頁中。請留意包含以下內容的項目:

  • HTTP 429
  • too_many_requests
  • dropbox: retry after
  • failed to copy: ... rate limit

在工作執行期間或完成後開啟日誌分頁,即可查看完整的錯誤訊息。若出現這些訊息,即可確認是速率限制問題,而非網路或憑證問題。

Checking Dropbox rate limit errors in RcloneView job logs

減少同時傳輸數量

Dropbox 速率限制的主要原因是同時發出過多的 API 呼叫。在 RcloneView 中,開啟您的同步工作並前往步驟 2(傳輸選項)。降低以下設定:

  • 傳輸數 (Transfers):針對 Dropbox,將預設值降至 2 或 3。相較於相容 S3 的供應商,Dropbox API 對並行數更為敏感。
  • 檢查器 (Checkers):降至 4 或更少。檢查器會執行檔案存在性與中繼資料查詢,這同樣會計入 Dropbox API 的請求限制。

儲存工作設定並重新執行。在大多數情況下,將並行數降至 2–3 個傳輸即可消除速率限制錯誤。

Adjusting transfer concurrency for Dropbox in RcloneView job settings

設定失敗時重試

RcloneView 會為工作傳遞 rclone 的重試設定。在工作選項中,請確認已啟用失敗時重試。預設情況下,rclone 會以指數退避方式重試失敗的傳輸,最多 3 次。當 Dropbox 回傳帶有 retry-after 標頭的 429 錯誤時,rclone 會遵循該標頭並在重試前等待 — 此內建行為可自動處理暫時性的速率限制。

若錯誤持續發生,您可以在進階工作選項中增加重試次數。對於非常龐大的 Dropbox 資料庫(超過 10 萬個檔案),將重試次數設為 5 次或以上,可讓工作更能應對間歇性的節流限制。

使用低流量時段

Dropbox 的速率限制在尖峰使用時段更為嚴格。將大型 Dropbox 同步工作排定於離峰時段(深夜或清晨)執行,能大幅降低觸及限制的機率。若擁有 PLUS 授權,可使用 RcloneView 中的排程器(cron scheduler),將 Dropbox 工作設定為 0 3 * * *(每日凌晨 3 點)執行。

Scheduling Dropbox sync job during off-peak hours in RcloneView

從工作歷史記錄重新執行失敗的工作

若 Dropbox 同步工作因速率限制而中途失敗,請勿從頭重新開始。前往工作歷史記錄 (Job History),找到失敗的執行紀錄並重新執行。RcloneView 會略過已成功傳輸的檔案,僅重試失敗的檔案。搭配降低並行數,可有效率地恢復同步。

開始使用

  1. rcloneview.com 下載 RcloneView
  2. 開啟您的 Dropbox 同步工作設定,前往步驟 2,將傳輸數降至 2–3,檢查器降至 4。
  3. 確認工作選項中已啟用失敗時重試。
  4. 工作歷史記錄重新執行工作,以從失敗處恢復。

透過調整並行數與重試設定,即使是大型資料庫,Dropbox 同步也能可靠地完成。


相關指南:

支援的雲端服務商

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