生产环境Google Picker选文件后Drive返回404文件未找到错误排查

问题背景 #

应用通过Google Picker选择文件后，调用Drive API下载时出现异常：

• 测试环境（未验证测试模式）运行正常，生产环境部分文件返回404错误
• 测试凭证调用API能正常获取文件详情，生产凭证调用返回File not found
• 异常文件通过Google Drive的「Open with」功能打开时可正常运行
• 测试与生产应用的配置、权限范围完全一致，权限包括：
  • .../auth/userinfo.email
  • .../auth/userinfo.profile
  • .../auth/drive.file
  • .../auth/drive.install

可能原因及对应解决方案 #

1. drive.file scope的授权关联缺失 #

drive.file是单文件+应用绑定的权限，仅允许应用访问用户明确授权过的文件。Google Picker只是文件选择界面，不会自动完成授权绑定：

• 检查生产环境是否在用户选择文件后，触发了针对该文件的授权流程（比如通过OAuth重新获取包含该文件权限的令牌）
• 确认Picker初始化时是否正确传递了生产环境的oauthToken，确保令牌与生产应用身份关联

2. 生产应用OAuth验证状态的权限限制 #

测试应用处于未验证测试模式，Google对其权限校验更宽松；已验证的生产应用可能存在隐藏校验逻辑：

• 检查Google Developer Console中生产应用的OAuth同意屏幕配置，确保所有声明的scope已通过验证
• 对于共享文件/团队盘文件，确认生产应用的客户端ID是否被添加到文件的共享权限列表中

3. Picker配置参数混用 #

即使整体配置一致，也可能存在细微参数差异：

• 对比测试与生产环境的Picker初始化代码，确保clientId、developerKey均为生产环境的正确值，未混用测试环境配置
• 确认Picker的setScopes方法中正确设置了drive.file等所需权限

4. 临时验证方案 #

若上述排查无果，可临时切换权限范围测试：

• 将生产应用的scope替换为https://www.googleapis.com/auth/drive.readonly，测试是否能访问异常文件。若正常，说明问题确实源于drive.file的授权绑定流程。

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