Spring Boot集成Google Sheets API反复要求手动授权如何解决

核心问题根因 #

Google OAuth默认颁发的access_token有效期仅1小时，你遇到的反复要求授权的问题，是refresh_token未正常存储/使用、授权逻辑重复触发两个问题共同导致的：

• 授权逻辑每次读Sheet时都重复执行，没有复用已有的授权凭证
• 没有拿到有效、长期的refresh_token自动刷新过期的access_token，就会触发手动授权引导

具体修复步骤 #

步骤1：改造授权逻辑为单例缓存，避免重复初始化 #

你当前代码每次调用读Sheet接口时，都会重新执行完整授权流程，改造为单例模式缓存授权后的Sheets实例即可，Credential本身自带自动刷新token的逻辑，只要持有有效refresh_token就会无感刷新：

public class SheetsServiceUtil {
    
    private static final String APPLICATION_NAME = "Google Sheets Read";
    // 缓存Sheets实例，仅初始化一次
    private static Sheets sheetsService;

    public static Sheets getSheetsService() throws IOException, GeneralSecurityException {
        if (sheetsService == null) {
            synchronized (SheetsServiceUtil.class) {
                if (sheetsService == null) {
                    Credential credential = GoogleAuthorizeUtil.authorize();
                    sheetsService = new Sheets.Builder(GoogleNetHttpTransport.newTrustedTransport(), JacksonFactory.getDefaultInstance(), credential)
                            .setApplicationName(APPLICATION_NAME)
                            .build();
                }
            }
        }
        return sheetsService;
    }

}

步骤2：强制获取refresh_token #

修改GoogleAuthorizationCodeFlow构造参数，添加强制授权提示，确保授权时返回refresh_token：

GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow
            .Builder(GoogleNetHttpTransport.newTrustedTransport(), JacksonFactory.getDefaultInstance(), clientSecrets, scopes)
            .setDataStoreFactory(new FileDataStoreFactory(new java.io.File(TOKENS_DIRECTORY_PATH)))
            .setAccessType("offline")
            // 新增参数，强制返回refresh_token
            .setApprovalPrompt("force")
            .build();

修改完成后先删除本地tokens目录下的所有缓存文件，重启应用完成一次授权，检查tokens目录下的存储文件确认存在refresh_token字段即可。

步骤3：调整OAuth应用发布状态 #

如果你的Google Cloud OAuth应用当前处于测试状态，测试状态下颁发的refresh_token有效期仅7天，到期就会强制重新授权。你可以将OAuth应用从「测试」调整为「正式发布」状态，正式发布后的应用颁发的refresh_token不会自动过期。

可选优化：改用服务账号授权 #

如果你的应用仅需要访问固定的内部Google Sheet，更推荐使用Google服务账号（Service Account）授权模式，无需手动授权、也不存在token过期问题：

1. 在Google Cloud控制台创建服务账号，下载JSON密钥文件
2. 将服务账号的邮箱地址添加到目标Google Sheet的共享用户列表，授予对应读写权限
3. 直接用服务账号密钥初始化Sheets客户端即可，无需回调、手动授权流程

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