调用Drive API v3的Files:list接口时提示共享驱动器不存在

云原生阿岚

2026-5-9

解决Google Drive API v3 Files:list接口返回"Shared drive not found"的404错误

我来帮你排查这个问题，虽然你是该共享驱动器的所有者，但遇到这个404错误通常有几个常见原因，咱们一步步来梳理：

仔细核对Drive ID的准确性
你提供的Drive ID是1_LWGJfL7OaVHEjMKU1IZ71qIRWh1_0_S，先确认这个ID完全正确——共享驱动器的ID可以通过Google Drive网页端查看：打开共享驱动器后，地址栏里https://drive.google.com/drive/u/0/folders/后面的字符串就是Drive ID，复制时别多了空格或者漏了字符，有时候复制粘贴会带隐藏的特殊字符，最好手动核对一遍。
确保API请求参数配置正确
调用Files:list接口访问共享驱动器时，指定driveId参数的同时，必须加上两个关键参数：includeItemsFromAllDrives=true和supportsAllDrives=true。这两个参数是API访问共享驱动器内容的必要条件，缺了任何一个都可能触发找不到资源的错误。给你一个示例请求格式参考：
```
GET https://www.googleapis.com/drive/v3/files?driveId=1_LWGJfL7OaVHEjMKU1IZ71qIRWh1_0_S&includeItemsFromAllDrives=true&supportsAllDrives=true&q=mimeType='application/vnd.google-apps.folder'
```
验证OAuth权限范围是否足够
检查你获取OAuth 2.0令牌时请求的权限范围，确保包含能访问共享驱动器的权限，比如全权限的https://www.googleapis.com/auth/drive（测试阶段可以先用这个），或者只读权限的https://www.googleapis.com/auth/drive.readonly。如果权限范围太局限，哪怕你是驱动器所有者，API也无法正常访问内容。
确认共享驱动器的状态
最后再确认下这个共享驱动器有没有被误删除或者转移了归属：登录Google Drive网页端，看看能不能直接找到这个驱动器；如果找不到，去“已删除的驱动器”列表里排查下是否被误删。