修复阿里云身份验证错误 — NetDrive

上周还能正常挂载阿里云存储桶的构建服务器，现在 NetDrive 显示凭据错误，从驱动器读取构建产物的夜间任务在第一个文件就失败了。机器上没有任何改动。阿里云驱动器无法通过身份验证时，原因几乎总是四个之一：访问密钥、其背后的权限、Endpoint，或存储桶名称。本指南按最快定位问题的顺序逐一说明。

让你的阿里云驱动器恢复使用

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

• 挂载前先测试凭据
• Drive Manager 显示每个驱动器的状态
• 重新连接时不会丢失挂载设置

WindowsmacOS

下载 NetDrive →

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

修改之前先读错误信息

保存阿里云驱动器时，NetDrive 会测试连接；凭据有问题时，会显示内联消息，而不是新的驱动器卡片。这条消息是你的第一条线索。密钥被拒绝，说明问题出在 Access Key ID 或密钥上。权限类的拒绝，说明问题出在密钥背后的 RAM 用户。完全无法访问存储桶，通常是 Endpoint 或存储桶名称的问题。

在编辑字段之前，先记下你遇到的是哪一种。同时改多个地方，就无法判断到底是哪一项解决了问题。

检查 1：访问密钥对

NetDrive 需要 Access Key ID 和对应的密钥。最常见的失败原因是密钥对已失效：

1. 登录阿里云控制台，打开拥有该密钥的 RAM 用户。
2. 确认密钥仍在列表中，且状态为启用而非禁用。
3. 如果密钥已轮换，NetDrive 中保存的旧密钥对就已失效。创建新的密钥对并立即复制两个值，因为密钥只显示一次。
4. 将新值粘贴到驱动器设置中。注意末尾的空格，复制时很容易带上。

属于已删除 RAM 用户的密钥与被禁用的密钥一样会失败，所以请确认该用户仍然存在。

检查 2：RAM 权限

即使密钥有效，如果 RAM 用户对存储桶没有权限，仍会被拒绝。日常挂载请使用 RAM 用户，而不是账号的根密钥，并确保其策略授予对你要挂载的那个存储桶的访问权限。如果驱动器需要写入文件，只读权限可以浏览，但第一次保存就会失败。

如果你最近收紧过策略，那很可能就是原因。请把策略与出错之前的情况对比。

检查 3：Endpoint 和存储桶名称

阿里云的 Endpoint 因地域而异，例如杭州是 oss-cn-hangzhou.aliyuncs.com。一个地域的存储桶不会在另一个地域的 Endpoint 上响应，所以从错误的项目复制粘贴会产生看起来像身份验证失败的错误。在控制台打开存储桶的 Overview 页面，从那里复制 Endpoint。

然后将 Bucket 字段与控制台逐字符比对。存储桶名称必须完全一致。哪怕错一个字符，或者存储桶被删除后在其他地域重新创建，症状都与密钥错误相同。

重新连接驱动器

修正出错的字段后：

1. 打开 NetDrive，在 Drive Manager 中找到阿里云驱动器。
2. 打开驱动器设置，更新密钥、密钥、Endpoint 或存储桶。
3. 点击 Test，等待 NetDrive 确认可以访问存储桶。
4. 保存，然后从其卡片连接驱动器。

如果编辑现有条目后错误仍未消除，请删除该驱动器，并在 Add Drive 对话框中用你在控制台核实过的值重新添加。全新的条目可以排除已保存的旧值带来的干扰。

身份验证通过但仍无法挂载

如果 Test 成功但驱动器仍未出现，问题已超出凭据范围。Windows 上驱动器号已被占用是常见原因，请参阅 Fix Drive Letter Already in Use。如果连接后文件夹显示为空或内容过时，请按照 Force Folder Refresh 中的说明手动刷新。

总结

把阿里云身份验证错误当作检查清单：密钥、权限、Endpoint、存储桶。一次只修一处，每次更改后使用 Test，并通过 Drive Manager 重新连接。完整的首次设置请参阅 Mount Alibaba Cloud on Windows with NetDrive。如果你使用的是姊妹服务，Mount Tencent Cloud on Windows 介绍了同样的流程。

— Steve, NetDrive