Maven Surefire插件多模块项目中无法执行单个测试问题咨询

• 首先核对测试类命名与Surefire扫描规则匹配性
  Surefire默认只会扫描命名符合Test*、*Test、*Tests、*TestCase规则的类，你所属模块继承了公司父POM，大概率父POM中自定义了Surefire的<includes>/<excludes>正则规则，可优先核对该测试类的命名是否命中了排除规则、未命中包含规则。可临时在当前模块的POM中覆盖Surefire配置，强制添加该类的包含规则验证：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
      <includes>
        <include>**/你的测试类名.java</include>
      </includes>
    </configuration>
  </plugin>
  

  若强制包含后可正常执行，即可确认是父POM的过滤规则导致。
• 检查测试类的修饰符与结构
  确认该测试类为public修饰、无abstract修饰符、存在无参public构造函数，部分旧版本Surefire的扫描逻辑会直接跳过不符合上述要求的类。
• 核对测试注解与引擎匹配性
  确认该测试类的@Test注解来源：若使用的是JUnit5的org.junit.jupiter.api.Test，需核对模块中是否存在junit-jupiter-engine依赖；你当前只引入了适配JUnit4的junit-vintage-engine，若该测试用了JUnit5注解，默认扫描时会被vintage引擎忽略，单独指定执行时JUnit平台可跨引擎查找用例，就会出现单独可跑、批量扫描不执行的情况。
• 核对分组过滤规则
  检查父POM中Surefire是否配置了<groups>/<excludedGroups>，以及该测试类/方法是否加了@Category（JUnit4）或@Tag（JUnit5）注解，刚好命中了排除分组的规则。
• 检查测试目录扫描配置
  确认父POM是否通过build-helper-maven-plugin等插件自定义了测试源目录，该测试类是否不在配置的扫描路径范围内。

直接执行以下命令即可输出完整的测试扫描、过滤全流程日志：

mvn test -Dsurefire.debug

该参数会打印所有扫描的目录、匹配的类、每个类被保留/过滤的原因，直接搜索你的测试类名即可定位到被排除的具体环节。
如果需要查看JUnit平台层面的测试发现逻辑，可额外添加参数：

mvn test -Dsurefire.debug -Djunit.platform.discovery.listener.enabled=true

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