Gradle test.environment 配置仅控制测试JVM启动时的环境变量，且默认不继承父进程环境；System.getenv() 在测试中为null通常因未显式配置或Shell/IDE隔离导致。
Gradle 构建脚本本身不直接暴露系统环境变量给 Java 测试代码——System.getenv() 在测试中能读到的，取决于 JVM 启动时继承的环境，而不是 Gradle 的 environment 配置块或 systemProperty。
Java 测试里 System.getenv("FOO") 为什么总是 null
常见现象：你在 build.gradle 里写了 test.environment FOO: "bar"，但测试类中 System.getenv("FOO") 返回 null。
原因很直接：Gradle 的 test.environment 只控制测试 JVM 进程启动时的环境变量，但它默认**不继承父进程（即 Gradle daemon）的环境**，除非你显式开启。
-
test.environment是“覆盖式”设置：只传你明确写的键值，不会自动带入JAVA_HOME、PATH或你本地终端里设的其他变量 - Windows 下若用 PowerShell 启动 Gradle，而测试 JVM 是 cmd 模式启动，某些变量可能因 shell 差异丢失
- IntelliJ IDEA 默认用“独立 JVM”运行测试，完全不继承 IDE 启动时的环境，
test.environment成为唯一入口
test.environment 和 systemProperty 到底该用哪个
选哪个，取决于你的 Java 测试代码怎么取值：
立即学习“Java免费学习笔记（深入）”；
- 如果代码写的是
System.getenv("API_URL")→ 必须用test.environment API_URL: "https://test.example.com" - 如果代码写的是
System.getProperty("api.url")→ 改用test.systemProperty "api.url", "https://test.example.com" - 混用风险高：不要一边在
test.environment里设DB_HOST，一边又在代码里误写成System.getProperty("DB_HOST") - Gradle 8.10+ 对
test.environment更严格：值必须是String，传null或数字会直接报错Cannot set environment variable 'X' to null
Gradle Wrapper 下环境变量不生效的典型场景
你执行 ./gradlew test，但 System.getenv("CI") 读不到 CI 系统注入的变量（比如 GitHub Actions 的 CI=true）。
这是因为：gradlew 脚本默认以“干净环境”启动 JVM，屏蔽了大部分父 shell 变量。解决方法只有两个：
- 显式转发：在
build.gradle中加test.environment System.getenv()—— 但注意这会把所有变量（含敏感信息如HOME、SSH_AUTH_SOCK）都透传进去，CI 场景慎用 - 精准注入：在 CI 配置里（如
.github/workflows/test.yml）用env:显式声明，并在build.gradle中对应写死 key，例如：test { environment "CI", System.getenv("CI") environment "GITHUB_REF", System.getenv("GITHUB_REF") } - Android 项目额外注意：AGP 8.0+ 会拦截部分环境变量，
ANDROID_HOME等会被重定向，不要依赖它判断本地 SDK 路径
测试代码读环境变量时最易忽略的点
不是配置没写对，而是 JVM 生命周期和构建阶段错位：
- 单元测试（
testtask）跑的是 forked JVM，test.environment生效；但集成测试（integrationTest）若用exec启动外部 Java 进程，则需单独配置其environment -
@BeforeAll静态方法里调用System.getenv()是安全的；但若在static final String URL = System.getenv("API_URL")这种类加载时初始化，可能因类加载顺序早于环境注入而得到null - Spring Boot Test 中，
@TestConfiguration类若依赖@Value("${env.var}")，那这个env.var来源是 Spring 的 PropertySource，和System.getenv()无关，别混为一谈
