如何使用google-api-java-client在无浏览器环境下实现OAuth2

好问题！我刚好在无浏览器的服务器环境里折腾过Google OAuth2认证，google-api-java-client完全支持不需要浏览器回调的认证方式，和Python的--non-local-browser逻辑类似，不过得手动实现对应的流程，或者换一种更适合服务器的认证方案。下面给你拆解两种最常用的方案：

方案1：设备授权流（对应Python的--non-local-browser） #

这种方式就是让用户在另一台有浏览器的设备（比如自己的手机/电脑）上输入一个授权码，完成认证，完全不需要服务器有浏览器。这和Python客户端的--non-local-browser本质是同一个OAuth2流程（Device Authorization Flow）。

实现步骤&代码示例 #

1. 首先在Google Cloud Console里创建OAuth客户端ID，类型选「其他」或者「桌面应用」（设备授权流对客户端类型要求宽松）。
2. 用google-api-java-client构建设备授权流：

import com.google.api.client.auth.oauth2.*;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.auth.oauth2.GoogleTokenResponse;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;

import java.io.FileReader;
import java.util.Arrays;

public class DeviceAuthFlowExample {
    private static final String CLIENT_SECRETS_PATH = "/path/to/your/client_secret.json";
    private static final String[] SCOPES = {"https://www.googleapis.com/auth/drive.readonly"};

    public static void main(String[] args) throws Exception {
        // 加载客户端密钥
        GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(
                GsonFactory.getDefaultInstance(),
                new FileReader(CLIENT_SECRETS_PATH)
        );

        // 初始化设备授权流
        DeviceAuthorizationFlow flow = new DeviceAuthorizationFlow.Builder(
                new NetHttpTransport(),
                GsonFactory.getDefaultInstance(),
                clientSecrets,
                Arrays.asList(SCOPES)
        ).build();

        // 获取设备码和用户授权链接
        DeviceCodeResponse deviceCodeResponse = flow.newDeviceTokenRequest().execute();
        System.out.println("请在浏览器中访问此链接：" + deviceCodeResponse.getVerificationUrl());
        System.out.println("然后输入授权码：" + deviceCodeResponse.getUserCode());

        // 轮询等待用户完成授权，获取访问令牌
        TokenResponse tokenResponse = flow.newTokenRequest(deviceCodeResponse.getDeviceCode())
                .setGrantType("urn:ietf:params:oauth:grant-type:device_code")
                .execute();

        // 这里可以保存凭证到文件，后续直接使用
        Credential credential = flow.createAndStoreCredential(tokenResponse, null);
        System.out.println("认证成功！访问令牌：" + credential.getAccessToken());
    }
}

这段代码会输出一个链接和授权码，用户在任意有浏览器的设备上打开链接输入码，服务器这边就能拿到凭证，完全不需要本地浏览器回调。

方案2：服务账号认证（完全无用户交互） #

如果你的场景是访问应用自己的数据，或者是G Suite/Google Workspace域内的用户数据（且域管理员已经授权服务账号访问），那服务账号认证是更简单的选择——不需要任何用户交互，直接用密钥文件就能生成凭证。

代码示例 #

import com.google.api.client.googleapis.auth.oauth2.GoogleCredentials;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;

import java.io.FileInputStream;
import java.util.Collections;

public class ServiceAccountExample {
    private static final String SERVICE_ACCOUNT_KEY_PATH = "/path/to/your/service-account-key.json";

    public static void main(String[] args) throws Exception {
        // 加载服务账号密钥
        GoogleCredentials credentials = GoogleCredentials.fromStream(new FileInputStream(SERVICE_ACCOUNT_KEY_PATH))
                .createScoped(Collections.singleton(DriveScopes.DRIVE_READONLY));

        // 创建API客户端
        Drive driveService = new Drive.Builder(
                GoogleNetHttpTransport.newTrustedTransport(),
                GsonFactory.getDefaultInstance(),
                credentials
        ).setApplicationName("My Server App").build();

        // 现在可以用driveService调用API了
        System.out.println("服务账号认证成功！");
    }
}

这种方式适合后台服务、定时任务等不需要用户参与的场景，完全跳过浏览器环节。

总结 #

• Java客户端没有直接的--non-local-browser命令行选项，但可以通过设备授权流实现和Python一样的无本地浏览器授权效果；
• 如果场景允许，服务账号认证是更省心的无交互方案；
• 两种方式都不需要服务器有浏览器，完美适配你的服务器环境。

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