跳到主要内容

修复 OneDrive 共享文件夹同步错误 — 使用 RcloneView 解决

· 阅读需 7 分钟
Tayson
Senior Engineer

诊断并修复 RcloneView 中 OneDrive 共享文件夹同步失败的问题 — 从权限错误、缺失的快捷方式到组织 OneDrive for Business 访问问题。

OneDrive 的共享文件夹系统有一些细微之处,容易让许多同步工具出错。同事与你共享的文件夹与你自己的 OneDrive 存储行为不同 — 它们在 API 中的表现方式不同,需要特定配置才能通过 rclone 访问。当 RcloneView 无法看到或同步某个共享文件夹时,根本原因几乎总是几个众所周知的问题之一。本指南涵盖了最常见的共享文件夹同步失败情况以及解决方法。

RcloneView 应用预览

在一个地方管理和同步所有云端

RcloneView 是 rclone 的跨平台 GUI。通过清爽的可视化界面比较文件夹、传输或同步文件,并自动化多云工作流。

  • 一键作业:复制 · 同步 · 比较
  • 调度器与历史记录,实现可靠的自动化
  • 支持 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
WindowsmacOSLinux
免费开始使用 →

核心功能免费。Plus 提供自动化功能。

RcloneView 中不显示共享文件夹

OneDrive 呈现共享文件夹的方式与你自己的存储不同。来自其他用户 OneDrive 的共享文件夹会出现在网页界面的“共享”部分下,但除非你已将其作为快捷方式添加到自己的 OneDrive 中,否则它们不会自动成为你 API 中根文件夹的一部分。

修复方法: 在 OneDrive 网页界面中,找到需要同步的共享文件夹,点击“添加快捷方式到我的文件”。这会在你自己的 OneDrive 根目录中创建一个快捷方式,可通过标准 API 访问 — 因此在 RcloneView 中也可见并可同步。添加快捷方式后,按 F5 或点击“重新加载”刷新 RcloneView 文件资源管理器。

OneDrive shared folder access configuration in RcloneView

同步共享文件夹时出现权限错误

同步 OneDrive 共享文件夹时出现 403 Forbidden 或“访问被拒绝”错误,通常表明以下三种情况之一:

  1. 只读共享: 文件夹所有者以仅查看权限共享了该文件夹。你无法向其写入或从中删除内容。如果你尝试的同步方向需要写入权限,请与文件夹所有者确认你是否拥有编辑权限。

  2. 访客访问限制: OneDrive for Business 上的外部(访客)账户具有受限的 API 访问权限。某些同步操作会被组织的共享策略阻止。

  3. 条件访问策略: 企业 Microsoft 365 租户可能会实施条件访问策略,限制来自不合规设备或应用程序的 API 访问。如果在成功登录后仍反复出现身份验证失败,请联系你的 IT 管理员。

Diagnosing OneDrive shared folder permission errors in RcloneView

OneDrive for Business 共享库问题

以 SharePoint 为后端的库(包括作为 OneDrive 文件夹公开的 SharePoint 文档库)需要在 RcloneView 中单独设置远程。请不要使用个人 OneDrive 远程,而是添加一个指向该站点 URL 的 SharePoint 远程,或使用带有相应 SharePoint 站点配置的 OneDrive for Business。

对于经常在 OneDrive for Business 上遇到路径长度错误的团队,rclone 的 --onedrive-no-versions 标志可以减少同步操作的 API 开销。可通过 RcloneView 中的“设置 > 内置 Rclone > 全局 Rclone 标志”添加自定义标志。

Reviewing OneDrive sync job history and error logs in RcloneView

重新验证失效的令牌

OneDrive OAuth 令牌可能会过期或失效 — 尤其是在更改密码、更新多因素身份验证或发生账户安全事件之后。失效的令牌在同步过程中表现为反复出现的 401 Unauthorized 错误。

要重新进行身份验证,请打开 RcloneView“远程”选项卡中的远程管理器,选择你的 OneDrive 远程,然后对其进行编辑。编辑流程会提示你重新运行 OAuth 流程,打开一个浏览器窗口进行全新身份验证。完成新的登录后,保存更新后的远程并重试同步任务。

开始使用

  1. rcloneview.com 下载 RcloneView
  2. 对于共享文件夹,请先在 OneDrive 网页界面中将它们添加为“快捷方式到我的文件”。
  3. 确认你对需要同步的文件夹拥有正确的权限(编辑权限,而不仅仅是查看权限)。
  4. 如果反复遇到 401 错误,请重新验证你的 OneDrive 远程。

大多数 OneDrive 共享文件夹问题都归结于 Microsoft 在 API 层面对拥有的文件夹、共享的文件夹和快捷方式文件夹之间的区分 — 理解这一点能让排查问题更加直接。


相关指南:

支持的云服务商

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