Gradle 6.9+SpringBoot 2.7.18环境下Pitest执行失败：未找到突变

使用Gradle 6.9 + SpringBoot 2.7.18运行Pitest时执行失败，Pitest配置如下：

pitest {
    targetClasses = ['com.cti.stan.*']
    enableDefaultIncrementalAnalysis = true
    reportDir = file("${buildDir}/reports/pit/${project.version}")
    outputFormats = ['HTML']
    pitestVersion = '1.7.4'
    timeoutConstInMillis = 10000
    mutationThreshold = 65
    timestampedReports=false
}

执行后报错提示未找到突变，错误日志：

> Task :pitest FAILED
15:41:02 PIT >> INFO : Verbose logging is disabled. If you encounter a problem, please enable it before reporting an issue.
15:41:03 PIT >> INFO : Incremental analysis reduced number of mutations by 0
15:41:03 PIT >> INFO : Created  0 mutation test units in pre scan
Exception in thread "main" org.pitest.help.PitHelpError: No mutations found. This probably means there is an issue with either the supplied classpath or filters.
See http://pitest.org for more details.
    at org.pitest.mutationtest.tooling.MutationCoverage.checkMutationsFound(MutationCoverage.java:352)
    ...
Execution failed for task ':pitest'.
> Process 'command 'C:\Program Files (x86)\Java\jdk1.8.0_241\bin\java.exe'' finished with non-zero exit value 1

原因分析 #

• 目标类匹配规则错误：com.cti.stan.*的通配符仅匹配当前包下的类，不包含子包；若项目中待突变的类存在于子包下，会导致扫描不到。此外，若目标包下仅包含接口、枚举、常量类等无法生成突变的类，也会出现此问题。
• 类路径扫描异常：Pitest可能无法定位到编译后的class文件，SpringBoot项目默认编译路径为build/classes/java/main，但自定义编译配置、依赖冲突可能导致路径失效。
• 增量分析干扰：开启enableDefaultIncrementalAnalysis后，若首次执行缓存异常或之前的扫描结果存在问题，会跳过类扫描流程，导致无突变单元生成。
• 版本兼容性问题：Pitest 1.7.4与Gradle 6.9、SpringBoot 2.7.18的组合可能存在兼容性缺陷，引发类扫描逻辑异常。

解决建议 #

• 修正目标类匹配规则：
  • 若需包含子包，将targetClasses改为['com.cti.stan..*']（两个点表示递归匹配子包）；
  • 确认目标包下存在可突变的类（包含业务逻辑的普通类），排除无法生成突变的类类型。
• 确保类路径正确：
  • 先执行./gradlew clean build生成最新的class文件；
  • 在Pitest配置中显式指定编译类路径：

    targetCodeDirs = [file("${buildDir}/classes/java/main")]
    

• 临时禁用增量分析：将enableDefaultIncrementalAnalysis设为false，重新执行Pitest，排查是否为缓存问题导致。
• 调整Pitest版本：尝试升级Pitest到1.9.0等兼容Gradle 6.x的稳定版本，解决版本兼容性问题。
• 开启详细日志排查：在配置中添加verbose = true，获取完整的扫描日志，确认类扫描的具体过程与拦截规则。

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