Gradle构建成功但执行命令时未运行带标记的JUnit测试用例

• 检查测试标签注解配置正确性

  JUnit 5场景：确认目标测试类/方法上添加了@Tag("regression")注解，标签拼写、大小写完全匹配传入的参数值，注意不要错导入JUnit 4的同名注解类。
  JUnit 4场景：确认目标测试类/方法上添加了@Category(Regression.class)注解，其中Regression为自定义的标签类，传入的tag参数值需要是该类的全限定名。

• 检查integrationTest任务的过滤规则配置
  确认build.gradle中过滤规则写在integrationTest任务下，不要错写到默认的test任务中，对应版本配置示例如下：
  JUnit5配置参考：

  integrationTest {
      useJUnitPlatform {
          if (project.hasProperty('tag')) {
              includeTags project.property('tag')
          }
      }
  }
  

  JUnit4配置参考：

  integrationTest {
      useJUnit {
          if (project.hasProperty('tag')) {
              includeCategories project.property('tag')
          }
      }
  }
  

• 确认测试文件符合integrationTest任务的扫描约定
  • 默认integrationTest任务扫描src/integrationTest/java目录下的测试文件，带标签的测试如果放在src/test/java目录下不会被识别
  • 检查测试类命名是否符合规则：通常要求类名以Test、Tests结尾，不符合命名规则的类不会被当作测试类扫描
  • 如果是自定义的integrationTest任务，需要确认任务已正确配置sourceSets指向你的集成测试代码目录
• 开启调试日志排查过滤逻辑
  执行带info日志的命令查看扫描细节：
  ./gradlew integrationTest -Ptag=regression --info
  在输出日志中搜索你的测试类名、标签匹配相关记录，可以明确看到测试类是未被扫描到，还是被标签规则过滤排除。
• 检查冲突规则与依赖完整性
  • 确认任务配置中没有额外的excludeTags/excludeCategories规则把regression标签排除
  • JUnit5场景下确认已引入JUnit Platform引擎相关依赖，依赖缺失会导致标签过滤功能不生效

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