mvn test 单元测试

### 可能原因分析 当 `mvn test` 命令不执行单元测试时，通常是因为以下几个原因之一： - **JUnit版本兼容性问题**：如果项目配置了JUnit 5 API但缺少必要的启动器依赖，则可能导致测试无法被识别和运行[^3]。 - **测试类命名或位置不符合约定**：Maven Surefire插件默认会查找特定模式下的测试类（如`Test`, `*TestCase`），若测试类名未按此规则定义可能不会被执行。 - **POM配置问题**：某些情况下，项目的`pom.xml`中可能存在影响测试行为的特殊配置项，比如设置了跳过测试选项 `<skipTests>true</skipTests>` 或者指定了错误的目标Java版本等[^5]。 - **内存不足导致失败**：在大规模并行执行大量测试的情况下，可能会遇到内存溢出异常(OOM)，这同样会影响部分甚至全部测试未能成功完成[^4]。 ### 解决方案建议 针对上述提到的各种可能性，以下是几种可行的解决方案： #### 配置正确的JUnit依赖 确保`pom.xml`中有如下形式的JUnit Jupiter引擎及其API依赖声明： ```xml <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-engine</artifactId> <version>${junit.jupiter.version}</version> <scope>test</scope> </dependency> <!-- 如果还需要支持旧版JUnit --> <dependency> <groupId>org.junit.vintage</groupId> <artifactId>junit-vintage-engine</artifactId> <version>${junit.jupiter.version}</version> <scope>test</scope> </dependency> ``` #### 调整Surefire Plugin设置 对于使用JUnit 5的情况，默认的Surefire插件版本可能不够新以至于不能很好地处理新的测试框架特性。因此应当显式指定较新版的插件，并开启对JUnit平台的支持： ```xml <build> ... <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.22.0+</version><!-- 使用最新稳定版 --> <configuration> <!-- 启用JUnit Platform --> <useSystemClassLoader>false</useSystemClassLoader> <includes> <include>**/*Test.java</include> <include>**/*Tests.java</include> <include>**/Test*.java</include> </includes> </configuration> </plugin> </plugins> ... </build> ``` #### 提升构建过程中的可用资源 为了避免因内存耗尽而导致的部分测试未能执行的问题，可以通过调整MAVEN_OPTS环境变量来增加分配给JVM的最大堆空间大小： ```bash export MAVEN_OPTS="-Xmx2g -XX:MaxPermSize=512m" ``` 也可以通过IDE内部配置实现相同效果，具体操作取决于所使用的开发工具。 #### 排查是否存在跳过测试标记 仔细检查整个工程内的XML文件以及命令行参数，确认没有任何地方意外启用了跳过测试的功能。特别是注意是否有类似下面这样的属性存在： ```xml <properties> <skipTests>true</skipTests> </properties> ```

### 使用 `mvn test` 运行 Maven 测试 Maven 提供了一个强大的插件——Surefire 插件，用于执行单元测试。通过配置 `pom.xml` 文件中的 `<build>` 和 `<plugins>` 部分，可以灵活控制哪些测试类会被执行以及如何执行这些测试。 #### 默认行为 当运行 `mvn test` 命令时，默认会扫描项目中所有的测试类并执行它们。默认情况下，Maven 会查找命名约定为 `*Test.java` 的测试类[^1]。 #### 自定义测试类的选择 如果需要指定某些特定的测试类来运行，可以在 `pom.xml` 中配置 `maven-surefire-plugin` 插件的 `<includes>` 或 `<excludes>` 参数。例如： ```xml <build> <plugins> <!-- 单元测试插件 --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>3.0.0-M3</version> <configuration> <includes> <!-- 只运行名称匹配 *Test.java 的测试类 --> <include>**/*Test.java</include> </includes> </configuration> </plugin> </plugins> </build> ``` 上述配置表示只运行那些名字以 `Test` 结尾的 Java 类作为测试类[^2]。 #### 排除不需要的测试类 有时可能有一些抽象类或其他不应该被执行的测试类。可以通过 `<excludes>` 来排除这些类。例如： ```xml <configuration> <includes> <include>**/*Tests.java</include> </includes> <excludes> <exclude>**/Abstract*.java</exclude> </excludes> </configuration> ``` 此配置将排除所有以 `Abstract` 开头的测试类。 #### 执行单个测试类 如果只想针对某一个具体的测试类运行测试，可以直接在命令行中使用 `-Dtest` 参数指定该类名。例如： ```bash mvn test -Dtest=MyTestClass ``` 这将会仅运行名为 `MyTestClass` 的测试类。 #### 解决常见问题 有时候可能会遇到即使有测试类存在但未被运行的情况。这种现象通常是因为 Surefire 插件版本过旧或者其依赖项不兼容造成的。例如，在引用[3]中提到的一个案例显示，由于 `surefire-junit4` 版本较低而导致 Cucumber 测试无法正常工作。因此建议始终使用最新稳定版的 Surefire 插件及其相关依赖项。 --- ### 示例代码片段 以下是完整的 `pom.xml` 配置示例，展示如何设置自定义的测试过滤器： ```xml <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>3.0.0-M5</version> <configuration> <includes> <include>**/*IntegrationTest.java</include> </includes> <excludes> <exclude>**/Abstract*.java</exclude> </excludes> </configuration> </plugin> </plugins> </build> ``` 在此配置下，只有命名为 `*IntegrationTest.java` 的测试类会被执行，而任何以 `Abstract` 开始的类都会被忽略[^3]。 ---