Gradle 7.6迁移至8.2遇'testFrameworkProperty'不可修改错误求助

错误原因 #

Gradle 8.0及以上版本中，Test任务的testFramework属性被标记为final，意味着只能在配置阶段设置，不能在任务执行阶段（比如doFirst闭包）修改测试框架的配置。你原来的代码把useJUnitPlatform放在doFirst里，属于执行阶段修改final属性，触发了这个错误。

修正方案 #

把测试框架的配置（useJUnitPlatform）从doFirst中移出，直接放到smoke任务的配置块内；系统属性设置这类执行阶段的操作可以保留在doFirst中。同时优化属性获取逻辑，避免属性不存在时抛出异常。

修正后的完整代码 #

buildscript {
    repositories {
        mavenLocal()
        mavenCentral()
        maven {
            url "https://plugins.gradle.org/m2/"
        }
    }
}

group 'com.orgs.project'
version '1.0'

apply plugin: 'java'
apply plugin: 'java-library'
apply plugin: 'idea'

dependencies {
    implementation group: 'javax.json', name: 'javax.json-api', version: '1.1.4'
    implementation group: 'org.glassfish', name: 'javax.json', version: '1.1'
    testImplementation 'org.apache.logging.log4j:log4j-core:2.10.0'
    testImplementation 'org.apache.logging.log4j:log4j-api:2.10.0'
    testImplementation 'io.cucumber:cucumber-java:3.0.2'
}

tasks.create(name: "smoke", type: Test) {
    outputs.upToDateWhen { false }
    ignoreFailures = true
    finalizedBy(aggregate)
    group = "Environments"

    // 把useJUnitPlatform移到配置阶段
    useJUnitPlatform {
        // 用findProperty避免属性不存在时报错
        if (project.findProperty('includeTags')) {
            includeTags project.findProperty('includeTags')
        }
        def targetTags = project.findProperty('tags') ?: ''
        project.logger.lifecycle("Targeting tags:${targetTags}")
        if (targetTags) {
            includeTags targetTags
        }
        excludeTags 'Progress'
    }

    doFirst {
        systemProperties System.properties
        if (System.properties.getProperty("${region}")) {
            project.logger.lifecycle("Running tests against:")
        }
    }
}

tasks.withType(Test) {
    //    maxParallelForks=2
    testLogging {
        events "FAILED",
                "SKIPPED",
                "STANDARD_ERROR",
                "STANDARD_OUT"
        exceptionFormat "FULL"
        showCauses true
        showExceptions true
        showStackTraces true
        showStandardStreams true
    }
}

关键修改点说明 #

• 移到配置阶段：useJUnitPlatform是配置测试框架的操作，必须在Gradle的配置阶段完成，不能放到执行阶段的doFirst里
• 安全获取属性：用project.findProperty()替代project.getProperty()，当属性不存在时返回null，避免构建失败
• 分离配置与执行逻辑：测试框架配置属于任务配置逻辑，系统属性传递、日志输出属于执行阶段逻辑，分开处理符合Gradle 8.x的规范

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