基于OAuth2的Google Sheets读写Servlet认证流程阻塞问题

嘿，我之前也踩过这个坑！你现在的问题核心在于命令行应用的OAuth2流程和Web Servlet的流程完全不兼容：

你之前用的是「其他」类型的客户端ID，对应桌面/命令行应用的授权逻辑——这种流程依赖本地交互（比如弹出浏览器让用户登录，再复制授权码回命令行）。但你的Servlet是运行在服务器上的Web应用，根本没法完成这种本地交互，所以代码会卡在获取Credential的步骤，因为它一直在等用户输入授权码，但Web环境里根本没有这个输入渠道。

下面是具体的解决步骤：

1. 更换客户端ID的应用类型 #

先去Google Cloud控制台，删掉原来的「其他」类型客户端ID，重新创建一个**「Web应用」类型的客户端ID。关键要配置授权重定向URI**：本地Jetty测试可以填http://localhost:8080/你的Servlet路径/oauth2callback，线上环境就填你的域名+对应路径。这个URI是Google授权完成后跳转回你应用的地址，必须和代码里的完全一致，差一个字符都会报错！

2. 调整OAuth2流程为Web应用模式 #

Web应用的OAuth2是授权码流程，分两步走：

• 第一步：用户访问你的Servlet时，把用户重定向到Google的授权登录页面；
• 第二步：用户授权后，Google会跳转到你配置的回调URI，你在回调接口里拿授权码交换访问令牌，生成可用的Credential。

给你一个简化的代码示例思路：

首先初始化AuthorizationCodeFlow（注意配置Web应用的参数）：

private static final String REDIRECT_URI = "http://localhost:8080/your-servlet/oauth2callback";
private AuthorizationCodeFlow flow;

@Override
public void init() throws ServletException {
    GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(
        JacksonFactory.getDefaultInstance(),
        new FileReader("path/to/client_secret.json")
    );
    flow = new AuthorizationCodeFlow.Builder(
        BearerToken.authorizationHeaderAccessMethod(),
        GoogleNetHttpTransport.newTrustedTransport(),
        JacksonFactory.getDefaultInstance(),
        new GenericUrl("https://oauth2.googleapis.com/token"),
        new BasicAuthentication(clientSecrets.getDetails().getClientId(), clientSecrets.getDetails().getClientSecret()),
        clientSecrets.getDetails().getClientId(),
        "https://accounts.google.com/o/oauth2/auth"
    )
    .setScopes(Collections.singleton(SheetsScopes.SPREADSHEETS))
    .setDataStoreFactory(new MemoryDataStoreFactory()) // 生产环境建议用持久化存储（比如数据库）
    .build();
}

然后处理GET请求，区分首次访问和回调：

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    String code = request.getParameter("code");
    if (code == null) {
        // 没有授权码，重定向到Google授权页
        AuthorizationCodeRequestUrl authUrl = flow.newAuthorizationUrl()
            .setRedirectUri(REDIRECT_URI)
            .setAccessType("offline"); // 请求离线访问，获取刷新令牌
        response.sendRedirect(authUrl.build());
    } else {
        // 拿到授权码，交换令牌
        TokenResponse tokenResponse = flow.newTokenRequest(code)
            .setRedirectUri(REDIRECT_URI)
            .execute();
        // 创建Credential并存入Session，供后续请求使用
        Credential credential = flow.createAndStoreCredential(tokenResponse, request.getSession().getId());
        request.getSession().setAttribute("credential", credential);
        
        // 这里可以跳转到业务页面，或者直接处理Sheets读写逻辑
        response.getWriter().println("授权成功！现在可以操作Google Sheets了");
    }
}

3. 额外注意事项 #

• 把Credential存在用户的HttpSession里，这样用户后续访问时不需要重复授权；
• 设置accessType="offline"可以获取刷新令牌，访问令牌过期时会自动刷新，不用用户再次登录；
• 生产环境不要用MemoryDataStoreFactory，建议用文件或数据库存储令牌，避免服务器重启后丢失。

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