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

在 Windows 或 macOS 上使用 NetDrive 挂载 Box
NetDrive 让 Google Drive、OneDrive、S3、SFTP、WebDAV 等在 Windows 和 macOS 上显示为本地驱动器 — 无需同步,无需完整下载。
- 在 Windows 上挂载为原生盘符,在 macOS 上挂载为卷
- 通过官方 Box API 进行 OAuth 授权 —— 密码不会以明文存储
- 与其他云存储驱动器一起在同一个驱动器管理器中使用
免费试用。提供终身与订阅方案。
Box 连接为何会中断
NetDrive 使用 OAuth 2.0 对接 Box 授权:首次设置驱动器时会打开一个浏览器窗口,你登录 Box 并授予访问权限,Box 随后返回一个访问令牌,由 NetDrive 存储并在每次后续连接时提交。该令牌会因以下几种具体原因而失效:
- 手动撤销应用授权。 如果你(或 Box 管理员)打开了 Box 的 Account Settings → Apps 页面,并将 NetDrive 从已授权应用列表中移除,令牌会立即失效。
- 企业应用审批策略。 Box 企业账户可以限制允许连接的第三方 OAuth 应用。如果你的 Box 管理员尚未明确批准 NetDrive,首次授权可能成功,但在续期时会被静默阻止。
- 密码变更或安全事件。 Box 密码更改,或 Box 检测到来自陌生位置的登录,都可能强制所有已连接的应用重新进行身份验证,NetDrive 也不例外。
- 会话或授权范围过期。 长期有效的令牌最终也会过期。如果驱动器长时间处于闲置状态,存储的令牌可能已经过旧而无法使用。

第一步 —— 确认是身份验证问题,而非网络问题
打开 NetDrive 的驱动器管理器,查看 Box 条目。身份验证失败会将驱动器显示为已断开或处于错误状态,而不仅仅是挂载较慢。在处理令牌之前,先检查其他已挂载的驱动器是否也出现故障——如果 Google Drive 或 S3 也同样超时,那问题出在你的网络或 Box 服务中断,而非 Box 授权本身。如果只有 Box 驱动器受影响,且错误文本提到了身份验证、授权或凭据,请继续第二步。
第二步 —— 重新授权 Box 驱动器
- 在驱动器列表中 Select the Box drive —— 先不要尝试挂载。
- 从驱动器列表中 Open the drive’s Edit panel(条目旁的编辑或设置图标)。
- 找到账户或身份验证部分并触发重新授权——这会在你的默认浏览器中打开 Box 登录页面。
- Sign in to Box 并再次批准访问请求。
- 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