Pitest 在多模块 Maven 项目中无法自动发现位于独立测试模块（如 CompanyprojectSaaS_JUnitTests）中的 JUnit 测试，因其默认仅扫描当前模块的 test-classes 目录，不支持跨模块类路径解析。
pitest 在多模块 maven 项目中无法自动发现位于独立测试模块（如 companyprojectsaas_junittests）中的 junit 测试，因其默认仅扫描当前模块的 test-classes 目录，不支持跨模块类路径解析。
Pitest 的核心设计假设是：被测代码（targetClasses）与测试代码（targetTests）位于同一 Maven 模块内，且编译后的测试字节码存在于该模块的 target/test-classes/ 路径下。从您提供的完整项目结构可见，测试类被集中放置在独立的 CompanyprojectSaaS_JUnitTests 模块中，而 Pitest 插件却配置在另一个模块（如 CompanyprojectSaaS_Processor_Example 或 CompanyProjectSaaS_Commons）的 pom.xml 中——这直接违反了 Pitest 的运行前提，导致其日志始终提示 Project has no tests, it is empty。
✅ 正确配置方案（推荐）
方案一：将测试迁入被测模块（最佳实践）
将 CompanyprojectSaaS_JUnitTests/src/test/java/br/com/company/project/junit/tests/ 下的测试类，按包结构复制到对应业务模块的 src/test/java/ 中。例如：
- 若
br.com.company.project.operations.*类位于CompanyprojectSaaS_Processor_Example模块，则应将相关测试类（如OperationsTest.java）放入该模块的：CompanyprojectSaaS_Processor_Example/src/test/java/br/com/company/project/operations/
同时更新 Pitest 配置中的 <targettests></targettests> 为实际包路径（注意：必须是编译后存在于本模块 target/test-classes 中的包）：
<configuration>
<targetClasses>
<param>br.com.company.project.operations</param>
</targetClasses>
<targetTests>
<!-- ✅ 此包必须在当前模块的 test-classes 中存在 -->
<param>br.com.company.project.operations</param>
</targetTests>
<!-- 其他配置保持不变 -->
</configuration>⚠️ 注意：
<targettests></targettests>匹配的是 测试类的全限定名（FQN），不是源码路径；Pitest 不解析源码，只扫描test-classes中的.class文件。
方案二：使用 testPlugin + 自定义 classpath（高级，不推荐日常使用）
若因历史原因必须保留分离测试模块，可尝试通过 pitest-maven 的 testPlugin 机制注入额外 classpath，但需手动指定 test-classes 输出目录（极不稳定，版本兼容性差，Pitest 官方明确不支持）：
<configuration>
<!-- ... targetClasses 等保持不变 -->
<testPlugin>custom</testPlugin>
<jvmArgs>
<arg>-Xbootclasspath/a:${project.basedir}/../CompanyprojectSaaS_JUnitTests/target/test-classes</arg>
</jvmArgs>
</configuration>⚠️ 此方式极易引发 ClassNotFoundException、NoClassDefFoundError 或测试类加载冲突，且 Pitest 1.14+ 已逐步弱化对此类 hack 的支持，强烈建议避免。
? 排查验证步骤（执行前必做）
-
确认测试已成功编译：在目标模块根目录下运行
mvn test-compile
检查
target/test-classes/是否生成了预期的.class文件（如br/com/company/project/operations/OperationsTest.class）。 -
验证 Surefire 是否能运行这些测试：
mvn surefire:test
若 Surefire 也找不到测试，说明问题根源在 Maven 测试生命周期配置，而非 Pitest 本身。
-
检查 JUnit 版本与插件匹配性：
您使用了pitest-junit5-plugin:0.14，请确保：- 项目实际使用 JUnit 5（
@Test来自org.junit.jupiter.api.Test）； -
maven-surefire-plugin版本 ≥ 2.22.0（否则无法识别 JUnit 5 测试）； - 移除
junit:junit（JUnit 4）依赖，避免混合冲突。
- 项目实际使用 JUnit 5（
? 总结
Pitest 的“模块隔离”限制并非缺陷，而是为保障突变分析的确定性与可重复性所作的有意设计。在多模块项目中，单元测试应与被测代码共处同一模块——这不仅满足 Pitest 要求，更符合 Maven 标准实践、提升构建可维护性，并避免 CI/CD 中因 classpath 错误导致的静默失败。重构测试位置虽需一次性投入，却是长期技术债的最优解。
