Gradle 8.0.2中test任务testFrameworkProperty属性不可修改报错求助

问题概述 #

原Gradle 7.5.1中正常运行的测试任务，升级至8.0.2后触发报错：

The value for task ':authority:test' property 'testFrameworkProperty' is final and cannot be changed any further.

使用的JUnit依赖：

• org.junit.jupiter:junit-jupiter-api:5.9.1
• org.junit.jupiter:junit-jupiter-engine:5.9.1
• org.junit.vintage:junit-vintage-engine:5.9.1
• org.junit.platform:junit-platform-runner:1.9.1

原test任务代码：

test{
  group= 'tddtest'
  description='Execute All TDD Unit Test cases'
  reports.html.outputLocation=file("reports/tdd/html")
  reports.junitXml.outputLocation=file("reports/tdd/xml")
  useJunit {
    includeCategories 'com.jb.controller.testCategory.TDDTest'
  }
}

原因分析 #

Gradle 8.0+对JUnit测试框架的配置逻辑做了调整：当classpath中存在JUnit 5依赖时，Gradle会自动默认使用JUnit Platform运行测试。此时手动调用useJunit()会强制尝试切换到JUnit 4测试框架，导致testFrameworkProperty这个final属性被重复修改，触发报错。

修复方案 #

将原有的useJunit()配置替换为JUnit Platform兼容的过滤配置，修改后的test任务代码如下：

test{
  group= 'tddtest'
  description='Execute All TDD Unit Test cases'
  reports.html.outputLocation=file("reports/tdd/html")
  reports.junitXml.outputLocation=file("reports/tdd/xml")
  
  // 启用JUnit Platform（适配JUnit 5 Jupiter/Vintage）
  useJUnitPlatform()
  
  // 通过filter块配置类别过滤，仅运行指定类别的测试
  filter {
    includeCategories 'com.jb.controller.testCategory.TDDTest'
  }
}

额外说明 #

1. Gradle 8.0+会自动识别classpath中的JUnit 5依赖，显式声明useJUnitPlatform()可避免配置歧义；
2. 已引入的junit-vintage-engine可确保兼容JUnit 4测试，无需额外配置；
3. 确保测试类的@Category注解正确指向com.jb.controller.testCategory.TDDTest类。

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