Google Drive API多文件夹搜索无结果，Try it now却正常的问题排查

问题详情 #

我需要在两个文件夹内搜索包含「mount」的内容，请求语句如下：

GET: https://www.googleapis.com/drive/v3/files?q=fullText contains 'mount' AND ('{folder_id}' in parents OR '{folder_id}' in parents)
Headers:
  Authorization: Bearer {access_token}

返回结果始终为空：

{
  "kind": "drive#fileList",
  "incompleteSearch": false,
  "files": []
}

无论是代码调用还是API客户端手动请求都无结果，但在Drive API的「Try it now」工具中使用完全相同的查询语句却能正常返回结果。单独搜索其中任意一个文件夹时请求正常，只要同时搜索两个就无结果。

当前使用权限 #

• drive 权限
• drive.file 权限
• drive.appdata 权限

已尝试的操作 #

• 对完整查询进行URL编码（包含/不包含单引号编码两种情况）
• 直接复制「Try it now」工具中生成的完整编码查询语句
• 减少搜索文件夹数量至1个（此场景下可正常返回结果）
• 调整搜索条件与文件夹查询的先后位置
• 将查询中的「AND」「OR」改为小写

排查建议 #

1. 严格校验URL编码：即使你尝试过编码，仍要确认整个q参数的编码是否完全符合标准。比如括号、空格、单引号这些特殊字符，必须用对应的URL编码替换（空格→%20，左括号→%28，右括号→%29）。建议用工具生成完整编码后的q值再发起请求。
2. 验证access_token权限：检查当前使用的access_token是否真的拥有两个目标文件夹的访问权限。可以通过token验证接口确认权限范围，避免出现权限仅覆盖单个文件夹的情况。
3. 核对文件夹ID准确性：再次确认两个文件夹ID的字符完全正确，包括大小写、长度，排除复制错误的可能。
4. 检查请求参数差异：对比「Try it now」工具的请求参数，看是否遗漏了关键参数（比如supportsAllDrives=true，如果文件夹属于共享云端盘的话；或是corpora参数设置不同）。这些参数会直接影响搜索范围。
5. 排除索引延迟问题：如果目标文件夹内的文件是最近新增/修改的，Drive的全文索引可能存在延迟，可等待10-15分钟后重试。

内容的提问来源于stack exchange，提问作者Airerr