修复 OneDrive 同步错误 — 如何使用 RcloneView 解决
RcloneView 中的 OneDrive 同步错误通常可归结为三种原因之一 — OAuth 令牌过期、API 速率限制或传输设置配置不当 — 每种原因在应用内都有明确的解决方法。
Microsoft OneDrive 是部署最广泛的商业云平台之一，但其 API 行为有时会产生同步错误，导致传输停滞、不完整或静默失败。RcloneView 通过带时间戳的日志、实时传输监控和精细的任务控制，为你提供一个结构化的诊断环境 — 无需进入命令行。
在一个地方管理和同步所有云端
RcloneView 是 rclone 的跨平台 GUI。通过清爽的可视化界面比较文件夹、传输或同步文件，并自动化多云工作流。
- 一键作业：复制 · 同步 · 比较
- 调度器与历史记录，实现可靠的自动化
- 支持 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
核心功能免费。Plus 提供自动化功能。
首先查看日志标签页
在更改任何设置之前，先打开 RcloneView 底部信息视图中的**日志（Log）**标签页。每次传输和同步操作都会在此写入带时间戳的记录，包括 OneDrive API 返回的错误代码。AccessDenied 或 InvalidAuthenticationToken 消息表示 OAuth 令牌已过期；429 Too Many Requests 消息表示触发了速率限制；而 EOF 或连接错误通常意味着网络中断，而非 OneDrive 特有的问题。
在进行任何更改之前先确定确切的错误类别可以节省时间 — 令牌问题的解决方法与速率限制的解决方法完全不同。
当 OAuth 令牌过期时重新进行身份验证
RcloneView 中的 OneDrive 连接使用 OAuth 浏览器身份验证。访问令牌会在活跃会话期间自动刷新，但如果远程长时间处于闲置状态，令牌可能会完全过期 — 导致所有针对该 OneDrive 账户的同步任务都以身份验证错误失败。
解决方法很简单：进入远程（Remote）标签页 > 远程管理器（Remote Manager），找到该 OneDrive 远程，点击编辑（Edit）。RcloneView 会打开一个浏览器窗口，让你重新登录并签发新的令牌。保存后，重新运行失败的任务。无需更改任务配置 — 只需刷新凭据即可。
减少并发传输以解决速率限制错误
OneDrive 对每个用户强制实施 API 速率限制，配置了大量并发文件传输的任务可能触发 429 响应 — 导致部分失败或重试，从而显著拖慢整个任务的进度。默认的重试次数（3 次）常常掩盖了速率限制问题，使其看起来像是间歇性错误。
在任务管理器（Job Manager）中打开该任务并点击编辑（Edit）。在第 2 步（高级设置）中，将**文件传输数量（Number of file transfers）**从默认值降低到 2 或 4。如果该任务使用了较高的相等性检查器数量，也应相应降低该值 — 官方建议对于响应元数据请求较慢的后端使用 4 个或更少。保存任务后再次运行。
在重新运行失败的任务前使用 Dry Run
部分同步可能会使目标文件夹处于不一致的状态 — 有些文件已传输，有些则没有。在重新运行失败的任务之前，使用 **dry run（试运行）**模式预览将要复制或删除的具体文件。Dry run 不会进行任何更改；它会生成一份完整的计划操作列表，供你验证任务是否能从中断处顺利完成。
在任务管理器中选择该任务，然后从执行选项中选择 Dry Run。仔细检查文件列表，尤其是当上一次任务运行期间源文件夹发生了变化时。
快速上手
- 从 rcloneview.com 下载 RcloneView。
- 任务失败后打开**日志（Log）**标签页，在做出更改之前先确定具体的错误类别。
- 对于身份验证错误，在远程管理器中编辑该 OneDrive 远程，并通过浏览器重新进行身份验证。
- 对于速率限制错误，在任务第 2 步的高级设置中将并发文件传输数降低到 2–4，然后先使用 dry run 预览再重新运行。
一旦你将解决方法与根本原因匹配起来，大多数 OneDrive 同步错误都能在几分钟内解决 — RcloneView 的任务历史记录和日志输出为你快速达成目标提供了所需的一切。
相关指南：
- 修复云传输停滞进度 — 如何使用 RcloneView 解决
- 将 OneDrive 迁移到 Amazon S3 — 使用 RcloneView 传输文件
- 将 Backblaze B2 同步到 OneDrive — 使用 RcloneView 进行云备份
支持的云服务商
