Spring集成Google Drive API测试阶段OAuth2 scope授权错误求助

问题原因及解决方法 #

1. 基础授权Scope缺失
   Spring Security的OAuth2登录默认依赖openid、profile、email三个基础Scope，你当前配置仅单独指定了Drive只读Scope，覆盖了默认必填的基础Scope，导致授权流程不完整触发报错。
   修正配置示例：

spring.security.oauth2.client.registration.google.scope=openid,profile,email,https://www.googleapis.com/auth/drive.readonly

也可以使用Spring预置的Drive权限别名简化配置：

spring.security.oauth2.client.registration.google.scope=openid,profile,email,drive.readonly

2. GCP侧Scope配置未同步
   仅在代码中声明申请的Scope无效，需要在GCP控制台同步配置允许的权限范围：

• 进入对应GCP项目的「API和服务」→「OAuth同意屏幕」页面
• 下滑到「权限范围」板块，点击「添加或移除权限」
• 搜索Google Drive API，勾选https://www.googleapis.com/auth/drive.readonly权限后保存更新
  确保GCP侧允许的Scope和代码中申请的Scope完全一致。

3. 测试用户配置异常
   检查「OAuth同意屏幕」→「测试用户」列表：

• 列表中必须包含你当前用于登录测试的完整Google邮箱地址，不支持别名邮箱、组邮箱作为测试用户
• 确认邮箱拼写无错误，刚添加的测试用户需要等待1-2分钟待配置生效后再测试

4. OAuth客户端配置不匹配
   确认两处配置一致性：

• Spring配置文件中的client-id、client-secret和GCP项目「API和服务」→「凭据」页面生成的Web应用OAuth2客户端参数完全一致
• 该OAuth客户端的「已授权重定向URI」列表中，已添加你Spring应用的登录回调地址，本地测试默认是http://localhost:8080/login/oauth2/code/google，线上环境替换为对应域名即可

内容的提问来源于stack exchange，提问作者Rafał Sokalski