如何在Java应用中设置GOOGLE_APPLICATION_CREDENTIALS环境变量？

下面是几种不需要每次手动设置终端环境变量的解决方案，按推荐程度排序：

1. 直接通过Google客户端API指定密钥文件（最推荐） #

很多Google Java SDK的客户端都支持直接在代码里指定密钥文件，完全绕开环境变量的问题，这是最可靠的方式，也方便其他用户使用——他们只需要替换密钥文件路径即可。

以Text-to-Speech为例，代码示例：

import com.google.cloud.texttospeech.v1.TextToSpeechClient;
import com.google.cloud.texttospeech.v1.TextToSpeechSettings;
import com.google.auth.oauth2.ServiceAccountCredentials;
import com.google.api.gax.core.FixedCredentialsProvider;
import java.io.FileInputStream;

public class TtsInitializer {
    public static TextToSpeechClient getTtsClient() throws Exception {
        // 加载本地密钥文件
        ServiceAccountCredentials credentials = ServiceAccountCredentials.fromStream(
            new FileInputStream("text-to-speech-key.json")
        );
        
        // 配置客户端设置
        TextToSpeechSettings settings = TextToSpeechSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credentials))
            .build();
        
        return TextToSpeechClient.create(settings);
    }

    public static void main(String[] args) {
        try (TextToSpeechClient client = getTtsClient()) {
            // 在这里编写你的TTS业务逻辑
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 通过JVM启动参数传递 #

如果不想修改太多代码，可以在启动Java程序时通过-D参数指定系统属性，Google的客户端会自动识别google.application.credentials这个属性，无需额外设置环境变量。

启动命令示例：

java -Dgoogle.application.credentials=text-to-speech-key.json YourMainClass

如果你的代码需要读取环境变量而非系统属性，也可以在程序启动时读取这个属性并映射到环境变量（用反射实现，因为Java本身不允许直接修改环境变量）：

import java.lang.reflect.Field;
import java.util.Map;

public class EnvUtils {
    public static void setEnvVar(String key, String value) {
        try {
            Map<String, String> env = System.getenv();
            Field field = env.getClass().getDeclaredField("m");
            field.setAccessible(true);
            ((Map<String, String>) field.get(env)).put(key, value);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        String credPath = System.getProperty("google.application.credentials");
        if (credPath != null) {
            setEnvVar("GOOGLE_APPLICATION_CREDENTIALS", credPath);
        }
        // 后续初始化客户端的代码
    }
}

3. 读取配置文件加载路径 #

可以在项目中放一个配置文件（比如app.properties），让程序启动时自动读取里面的密钥路径，再设置环境变量。这种方式对其他用户友好，他们只需修改配置文件即可。

1. 创建app.properties文件：

google.credentials.path=text-to-speech-key.json

2. 代码读取并设置：

import java.io.FileInputStream;
import java.util.Properties;

public class ConfigLoader {
    public static void loadCredentialsPath() {
        Properties props = new Properties();
        try (FileInputStream fis = new FileInputStream("app.properties")) {
            props.load(fis);
            String credPath = props.getProperty("google.credentials.path");
            if (credPath != null) {
                EnvUtils.setEnvVar("GOOGLE_APPLICATION_CREDENTIALS", credPath);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        loadCredentialsPath();
        // 初始化客户端
    }
}

为什么.bash_profile没生效？ #

VS Code的终端可能没有加载.bash_profile（比如用的是zsh，对应.zshrc；或者终端是login shell vs non-login shell的区别）。但就算生效了，这种方式也只对你的机器有效，其他用户用你的应用时还是得自己配置，所以不推荐。

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