修复 NetDrive 挂载 Box 时的身份验证错误

阅读时间 4 分钟 troubleshooting box
Casey
CaseyProduct Manager
NetDrive 的 Box 驱动器一直处于错误状态或无法挂载?这里说明 Box OAuth 令牌失效的原因,以及几分钟内重新授权连接的方法。

一个连续几周正常挂载的 Box 驱动器,突然显示红色错误图标,或者点击 Mount 后一直转圈并超时。Box 通过 OAuth 2.0 与 NetDrive 连接,与浏览器会话在后台静默刷新不同,一旦令牌被撤销或过期,驱动器就会卡住,直到你手动重新授权。本文将介绍两种最常见的原因及各自的解决方法。

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive lettersMounted clouds appearing as native drives in Windows File Explorer

在 Windows 或 macOS 上使用 NetDrive 挂载 Box

NetDrive 让 Google Drive、OneDrive、S3、SFTP、WebDAV 等在 Windows 和 macOS 上显示为本地驱动器 — 无需同步,无需完整下载。

  • 在 Windows 上挂载为原生盘符,在 macOS 上挂载为卷
  • 通过官方 Box API 进行 OAuth 授权 —— 密码不会以明文存储
  • 与其他云存储驱动器一起在同一个驱动器管理器中使用
WindowsmacOS
下载 NetDrive →

免费试用。提供终身与订阅方案。

Box 连接为何会中断

NetDrive 使用 OAuth 2.0 对接 Box 授权:首次设置驱动器时会打开一个浏览器窗口,你登录 Box 并授予访问权限,Box 随后返回一个访问令牌,由 NetDrive 存储并在每次后续连接时提交。该令牌会因以下几种具体原因而失效:

  • 手动撤销应用授权。 如果你(或 Box 管理员)打开了 Box 的 Account Settings → Apps 页面,并将 NetDrive 从已授权应用列表中移除,令牌会立即失效。
  • 企业应用审批策略。 Box 企业账户可以限制允许连接的第三方 OAuth 应用。如果你的 Box 管理员尚未明确批准 NetDrive,首次授权可能成功,但在续期时会被静默阻止。
  • 密码变更或安全事件。 Box 密码更改,或 Box 检测到来自陌生位置的登录,都可能强制所有已连接的应用重新进行身份验证,NetDrive 也不例外。
  • 会话或授权范围过期。 长期有效的令牌最终也会过期。如果驱动器长时间处于闲置状态,存储的令牌可能已经过旧而无法使用。

NetDrive 驱动器管理器显示多个已挂载为盘符的云存储驱动器,其中包含一个已断开连接的条目

第一步 —— 确认是身份验证问题,而非网络问题

打开 NetDrive 的驱动器管理器,查看 Box 条目。身份验证失败会将驱动器显示为已断开或处于错误状态,而不仅仅是挂载较慢。在处理令牌之前,先检查其他已挂载的驱动器是否也出现故障——如果 Google Drive 或 S3 也同样超时,那问题出在你的网络或 Box 服务中断,而非 Box 授权本身。如果只有 Box 驱动器受影响,且错误文本提到了身份验证、授权或凭据,请继续第二步。

第二步 —— 重新授权 Box 驱动器

  1. 在驱动器列表中 Select the Box drive —— 先不要尝试挂载。
  2. 从驱动器列表中 Open the drive’s Edit panel(条目旁的编辑或设置图标)。
  3. 找到账户或身份验证部分并触发重新授权——这会在你的默认浏览器中打开 Box 登录页面。
  4. Sign in to Box 并再次批准访问请求。
  5. Save 驱动器配置,然后返回 NetDrive。

如果 Box 登录页面始终无法打开,请检查企业代理或防火墙是否阻止了默认浏览器,并在重试前确认可以直接访问 box.com

第三步 —— 验证驱动器是否成功挂载

回到驱动器列表,点击 Mount。重新授权后首次连接时请等待 10–15 秒——NetDrive 需要从 Box 获取最新的目录列表,驱动器才会出现在 Windows 资源管理器或 Finder 中。

如果重新授权后仍然失败,请再检查以下两点:

  • 管理员审批待处理。 在受管理的 Box 企业环境中,请询问 Box 管理员 NetDrive 是否在已批准的第三方应用列表中。用户级别的重新授权无法覆盖管理员级别的阻止。
  • macOS 上的过期凭据缓存。 打开 Keychain Access,搜索与 Box 或你的 Bdrive 账户相关的条目,删除看起来重复或已过期的条目,然后再重复第二步。

保持 Box 连接稳定

驱动器成功挂载并正常工作后,除非你确实打算彻底断开连接,否则应避免从 Box 的 Apps 列表中撤销 NetDrive——这会再次触发完整的重新授权流程。如果你的组织集中管理 Box,请让 IT 部门在任何 Box 安全策略更新后确认 NetDrive 仍在已批准应用列表中,因为此类更新是上述错误的常见触发因素。

关于各平台的初始设置,请参阅 在 Windows 上使用 NetDrive 挂载 Box在 macOS 上使用 NetDrive 挂载 Box。多人共用一个 Box 驱动器的团队,也可以参考 NetDrive 团队驱动器,它可以将驱动器发布给成员,而无需分发各自的凭据。

— Casey, NetDrive