Gradle构建JavaFX应用单元测试报错：Gradle Test Executor退出值1

1. 先获取详细错误日志 #

默认提示过于笼统，执行以下命令获取完整日志：

# Linux/Mac
./gradlew test --info

# Windows
gradlew.bat test --info

或者在build.gradle中添加测试日志配置，重新运行测试即可看到具体异常：

test {
    testLogging {
        exceptionFormat = 'full'
        showStackTraces = true
        showStandardStreams = true
    }
}

2. 修正JavaFX测试依赖配置 #

Gradle构建JavaFX应用时，测试环节需额外配置对应依赖，尤其是JUnit 5场景：

plugins {
    id 'java'
    id 'org.openjfx.javafxplugin' version '0.0.13'
}

javafx {
    version = '21' // 替换为你的JavaFX版本
    modules = ['javafx.controls', 'javafx.fxml'] // 匹配应用用到的模块
}

dependencies {
    // JUnit 5核心依赖
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.0'
    // 测试运行时需添加对应平台的JavaFX依赖
    testRuntimeOnly 'org.openjfx:javafx-controls:21:win' // 替换为win/mac/linux
    testRuntimeOnly 'org.openjfx:javafx-fxml:21:win'
}

test {
    useJUnitPlatform()
    // 解决JavaFX模块访问限制问题
    jvmArgs += '--add-opens=javafx.graphics/javafx.scene=ALL-UNNAMED'
    jvmArgs += '--add-opens=javafx.controls/javafx.scene.control=ALL-UNNAMED'
}

若为模块化项目（含module-info.java），需在测试模块中声明依赖：

module your.app.module {
    requires javafx.controls;
    requires javafx.fxml;
    requires org.junit.jupiter.api;
    // 允许JUnit访问主模块内部类（按需添加）
    opens com.your.app to org.junit.jupiter.api;
}

3. 处理JavaFX测试环境初始化问题 #

若测试涉及JavaFX组件（如Stage、Button），需确保JavaFX环境正确启动：

• 推荐使用TestFX框架简化测试，添加依赖：

  testImplementation 'org.testfx:testfx-core:4.0.16-alpha'
  testImplementation 'org.testfx:testfx-junit5:4.0.16-alpha'
  

  测试类可继承ApplicationTest或使用@Start注解启动环境。
• 手动初始化JavaFX：

  @BeforeAll
  static void setupJavaFX() {
      if (!Platform.isFxApplicationThread()) {
          Platform.startup(() -> {});
      }
  }
  

4. 检查版本兼容性 #

确保Gradle、Java、JavaFX版本匹配：

• Java 17+ 建议搭配Gradle 7.5+
• JavaFX 21 建议搭配Gradle 8.0+
  可通过./gradlew --version查看当前Gradle版本，必要时在gradle/wrapper/gradle-wrapper.properties中更新：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip

5. 排查测试类本身问题 #

• 检查测试类是否存在语法错误、静态初始化块异常
• 确认测试方法无未捕获的运行时异常
• 验证测试资源文件（如fxml）是否放置在src/test/resources对应路径下

内容的提问来源于stack exchange，提问作者César Guimarães