修復 Box 上傳錯誤 — 如何使用 RcloneView 解決傳輸問題
一個 Box API 錯誤就可能悄悄卡住同步工作 — 以下說明如何診斷確切原因，並在 RcloneView 中修復它。
Box 是廣泛使用的企業雲端平台，但其 API 強制執行速率限制、權杖到期時間窗口，以及檔案路徑規則，這些都可能導致上傳在傳輸過程中失敗。當同步工作在沒有明確訊息的情況下停止時，大多數使用者會重新啟動整個工作並寄望運氣更好。RcloneView 提供結構化的日誌輸出、可設定的重試行為，以及針對每個遠端的驗證控制 — 這些正是找出真正問題並防止其再次發生的正確工具。
在同一處管理與同步所有雲端
RcloneView 是 rclone 的跨平台 GUI。透過清爽的視覺化介面比較資料夾、傳輸或同步檔案，並自動化多雲工作流程。
- 一鍵作業：複製 · 同步 · 比較
- 排程器與歷史記錄，打造可靠的自動化
- 支援 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
核心功能免費。Plus 提供自動化功能。
Box 上傳錯誤的常見原因
Box 上傳失敗大致可分為幾個類別。API 速率限制是最常見的元兇：當 RcloneView 傳送過多並行請求時，Box 會回傳 HTTP 429 錯誤並限流連線。對 Box 執行超過預設數量的並行傳輸就可能觸發此問題，尤其是在具有更嚴格 API 配額的 Box for Business 帳戶上。
OAuth 權杖過期是第二大主因。Box 存取權杖會在固定期限後過期。如果長時間執行的工作在權杖過期時仍在進行中，上傳就會開始出現驗證錯誤。RcloneView 會安全地儲存您的 Box 憑證，並在存取權杖過期時自動更新，但如果重新整理權杖本身已過期（通常是在長時間未使用之後），您就需要重新驗證該遠端。
檔案路徑與命名問題也會導致錯誤。Box 對某些特殊字元及檔案路徑長度有限制。含有 Box 不接受的字元的檔案會靜默失敗，除非啟用了日誌記錄。
閱讀日誌以找出確切錯誤
在變更任何設定之前，先啟用除錯日誌以擷取完整的錯誤情境。在 RcloneView 中，前往 Settings > Embedded Rclone，勾選 Enable rclone Logging，然後將日誌等級設為 DEBUG。點擊 Restart Embedded Rclone，接著重現上傳失敗的情況。從設定的日誌資料夾中開啟日誌檔案 — 來自 Box 的錯誤代碼與 HTTP 回應會被清楚記錄下來。
或者，也可以查看 RcloneView 介面底部的 Log tab，以檢視目前工作階段中帶有時間戳記的錯誤項目。Job History 分頁（可透過 Job Manager 存取）會記錄每個過去工作的狀態、持續時間與傳輸速度。以「Errored」狀態完成的工作會包含界定問題範圍所需的檔案數量與大小資訊。
調整傳輸設定以符合 Box 的限制
確認錯誤類型後，在 Job Manager 中開啟受影響的工作並點擊 Edit。在第 2 步（Advanced Settings）中，降低 Number of file transfers 以減少並行請求數量 — 對 Box 而言，從 2 或 3 開始是安全的基準值。同時將 Number of equality checkers 降至 4 或更少，因為 Box 在中繼資料方面對高並行度也可能吃力。
將 Retry entire sync if fails 的次數從預設的 3 提高到 5 或更高，以應對不穩定的網路狀況。RcloneView 的重試邏輯會在後續執行中略過已傳輸的檔案，因此重試不會重複工作 — 它會從上次嘗試中斷的地方繼續。若資料完整性至關重要，可啟用 checksum 驗證，不過這會增加請求量，因此應搭配較低的並行設定一起使用。
當權杖錯誤持續發生時重新驗證 Box
如果即使降低並行數後，日誌仍顯示持續的驗證失敗，就代表需要重新整理 Box OAuth 權杖。在 RcloneView 中，前往 Remote tab > Remote Manager，選取您的 Box 遠端，然後點擊 Edit。重新執行 OAuth 流程會開啟瀏覽器視窗，讓您再次登入 Box，並核發一組全新的權杖。對於 Box for Business 帳戶，儲存 前請確認遠端設定中仍存在 box_sub_type = enterprise 這項設定。
重新驗證後，再次執行該工作。使用 Dry Run 選項（可在 Job Manager 中取得）可預覽將傳輸哪些檔案，而不會實際進行變更 — 這能讓您在提交完整上傳之前，先確認連線正常且檔案清單符合預期。
開始使用
- 從 rcloneview.com 下載 RcloneView。
- 在 Settings > Embedded Rclone 中啟用 DEBUG 日誌記錄，並重現上傳錯誤以擷取確切的錯誤代碼。
- 在 Job Manager 中編輯失敗的工作，將並行傳輸數降至 2–3，並提高重試次數。
- 如果驗證錯誤持續發生，請透過 Remote Manager 重新驗證 Box 遠端，並在執行完整工作前使用 Dry Run 確認連線狀況。
只要有正確的並行設定與有效的權杖，透過 RcloneView 進行的 Box 上傳就能可靠運作 — 即使是橫跨數萬個檔案的大型企業封存也不例外。
相關指南：
支援的雲端服務商
