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
  </targetclasses><targettests><!-- ✅ 此包必须在当前模块的 test-classes 中存在 --><param>br.com.company.project.operations
  </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 的支持，强烈建议避免。

? 排查验证步骤（执行前必做）

1. 确认测试已成功编译：在目标模块根目录下运行

   mvn test-compile

   检查 target/test-classes/ 是否生成了预期的 .class 文件（如 br/com/company/project/operations/OperationsTest.class）。

2. 验证 Surefire 是否能运行这些测试：

   mvn surefire:test

   若 Surefire 也找不到测试，说明问题根源在 Maven 测试生命周期配置，而非 Pitest 本身。

3. 检查 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）依赖，避免混合冲突。

? 总结

Pitest 的“模块隔离”限制并非缺陷，而是为保障突变分析的确定性与可重复性所作的有意设计。在多模块项目中，单元测试应与被测代码共处同一模块——这不仅满足 Pitest 要求，更符合 Maven 标准实践、提升构建可维护性，并避免 CI/CD 中因 classpath 错误导致的静默失败。重构测试位置虽需一次性投入，却是长期技术债的最优解。