Gradle集成测试因System.getProperty('zap.port')为空报错

问题根源 #

核心问题出在JVM隔离和任务执行顺序：

• Gradle构建进程与测试运行进程是两个独立的JVM实例，你在integrationTest配置块中调用的System.setProperty仅修改了Gradle自身JVM的属性，测试进程完全读取不到。
• 原配置中integrationTest未依赖reservePorts，导致配置阶段执行System.setProperty时，zapPort还处于初始的null状态。

解决方案 #

修改integrationTest任务配置，做两个关键调整：

1. 添加对reservePorts的依赖，确保端口先分配完成再启动测试
2. 使用Gradle Test任务专属的systemProperty方法，给测试JVM传递属性（而非修改Gradle进程的系统属性）

修改后的integrationTest代码 #

task integrationTest(type: Test, dependsOn: [downloadFioridastItsWar, reservePorts]) {
    // 用systemProperty为测试JVM设置系统属性，测试进程才能读取到对应值
    systemProperty "zap.port", project.ext.zapPort
    systemProperty "jetty.port", project.ext.jettyPort
    
    ignoreFailures = true
    testClassesDirs = sourceSets.integrationTest.output.classesDirs
    classpath = sourceSets.integrationTest.runtimeClasspath
    testLogging {
        events 'PASSED', 'FAILED', 'SKIPPED'
    }
}

原理说明 #

• dependsOn: [downloadFioridastItsWar, reservePorts]强制Gradle在执行阶段先完成端口分配，再启动测试进程，保证zapPort有有效值
• systemProperty方法会在启动测试JVM时，将属性以-Dkey=value的形式传递给测试进程，此时测试代码中System.getProperty("zap.port")就能正确获取到动态分配的端口值

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