使用Drive API查询文件时部分账号出现500内部服务器错误求助

问题背景 #

我需要查询两类文件：自己拥有的根目录下的文件/文件夹，以及共享给我的项目。使用的查询语句是：
((not 'me' in owners and sharedWithMe) or 'root' in parents)

但部分用户账号调用时出现500 Internal Server Error，其他账号可正常运行。

使用的依赖版本：

• google-api-client : 1.35.0
• google-api-services-drive : v3-rev197-1.25.0

相关错误日志：

com.google.api.client.googleapis.json.GoogleJsonResponseException: 500 Internal Server Error
GET https://www.googleapis.com/drive/v3/files?corpora=user,allTeamDrives&fields=nextPageToken,%20files(mimeType,headRevisionId,createdTime,id,lastModifyingUser,modifiedTime,name,owners,ownedByMe,parents,permissions,shared,size,trashed,capabilities,webContentLink,teamDriveId)&includeItemsFromAllDrives=true&orderBy=folder,name_natural&q=trashed%20%3D%20false%20and%20('me'%20in%20owners%20and%20'root'%20in%20parents)%20or%20(sharedWithMe)&supportsAllDrives=true
at com.google.api.client.googleapis.json.GoogleJsonResponseException.from(GoogleJsonResponseException.java:146)
at com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest.newExceptionOnError(AbstractGoogleJsonClientRequest.java:118)
at com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest.newExceptionOnError(AbstractGoogleJsonClientRequest.java:37)
at com.google.api.client.googleapis.services.AbstractGoogleClientRequest$1.interceptResponse(AbstractGoogleClientRequest.java:439)
at com.google.api.client.http.HttpRequest.execute(HttpRequest.java:1111)
at com.google.api.client.googleapis.services.AbstractGoogleClientRequest.executeUnparsed(AbstractGoogleClientRequest.java:525)
at com.google.api.client.googleapis.services.AbstractGoogleClientRequest.executeUnparsed(AbstractGoogleClientRequest.java:466)
at com.google.api.client.googleapis.services.AbstractGoogleClientRequest.execute(AbstractGoogleClientRequest.java:576)

排查方向与解决方法 #

1. 修正查询语句逻辑优先级 #

从日志的实际请求参数可以看到，查询被解析为：
trashed = false and ('me' in owners and 'root' in parents) or (sharedWithMe)
这和原本的逻辑不符——原本需要先组合((not 'me' in owners and sharedWithMe) or 'root' in parents)，再结合trashed=false，但当前逻辑会导致查询范围异常，部分账号因数据量或权限结构触发服务器错误。

正确的查询语句需给核心逻辑加外层括号：
trashed = false and ((not 'me' in owners and sharedWithMe) or 'root' in parents)

2. 拆分查询请求 #

单条复杂查询在部分账号（如拥有大量共享文件、团队盘数据）中容易触发服务器内部错误。可拆分为两个独立查询，再在代码中合并结果：

• 查询自己根目录下的文件：trashed = false and 'root' in parents and 'me' in owners
• 查询共享给自己的文件：trashed = false and sharedWithMe and not 'me' in owners

3. 更新依赖版本 #

当前使用的google-api-services-drive版本为v3-rev197-1.25.0，属于较旧版本，可能存在已知API兼容问题。建议升级至稳定新版本：

• google-api-client: 2.0.0+
• google-api-services-drive: v3-rev20240529-2.0.0

4. 检查异常账号的Drive状态 #

部分账号可能存在特殊情况：

• 拥有大量共享文件或团队盘数据，导致单次查询返回数据量过大
• 存在权限异常的文件（如已删除但未清理的共享记录）
  可先让异常账号手动清理无效共享文件，或增加日期过滤条件缩小查询范围测试。

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