Maven 中 maven.test.skip 与skipTests 区别

在 Maven 中，maven.test.skip 和 skipTests 都用于控制测试的跳过行为，但它们的作用范围 和底层机制有显著区别。以下是详细对比：

---

1. maven.test.skip

定义

maven.test.skip 是一个用户自定义属性（需在 pom.xml 的 <properties> 中显式声明），通常由插件（如 maven-surefire-plugin 和 maven-compiler-plugin）读取。

作用

• 跳过测试代码的编译和执行
  当设置为 true 时：
  • maven-compiler-plugin 不会编译 src/test/java 下的测试代码。
  • maven-surefire-plugin 不会执行任何测试。

配置示例

<properties>
    <maven.test.skip>true</maven.test.skip> <!-- 默认 false -->
</properties>

命令行覆盖

mvn install -Dmaven.test.skip=true

适用场景

• 需要完全跳过测试的编译和执行（节省时间，适用于 CI/CD 中的快速构建）。

---

2. skipTests

定义

skipTests 是 Maven 的内置属性 ，直接由 maven-surefire-plugin（测试执行插件）和 maven-failsafe-plugin（集成测试插件）识别，无需在 pom.xml 中声明。

作用

• 仅跳过测试执行，但会编译测试代码
  当设置为 true 时：
  • 测试代码（src/test/java）仍会被编译。
  • 测试类不会被执行。

配置示例

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.2.5</version>
    <configuration>
        <skipTests>true</skipTests> <!-- 默认 false -->
    </configuration>
</plugin>

命令行覆盖

mvn install -DskipTests=true

适用场景

• 需要编译测试代码但临时跳过执行（例如调试时保留测试代码）。

---

核心区别对比

特性	maven.test.skip	skipTests
作用范围	跳过测试代码的编译和执行	仅跳过测试执行（测试代码仍会编译）
属性类型	用户自定义属性（需在 pom.xml 声明）	Maven 内置属性（无需声明）
影响的插件	maven-compiler-plugin + maven-surefire-plugin	maven-surefire-plugin / maven-failsafe-plugin
编译测试代码	❌ 不编译	✅ 编译
执行测试	❌ 不执行	❌ 不执行
推荐使用场景	完全跳过测试（如生产环境构建）	临时跳过测试（如调试或快速验证）

---

如何选择？

1. 需要完全跳过测试（不编译、不执行）

   mvn install -Dmaven.test.skip=true

2. 需要编译测试代码但跳过执行

   mvn install -DskipTests=true

3. 在 pom.xml 中永久配置

   • 如果希望默认跳过测试，建议使用 skipTests（语义更明确）：

     <plugin>
         <artifactId>maven-surefire-plugin</artifactId>
         <configuration>
             <skipTests>true</skipTests>
         </configuration>
     </plugin>

---

常见问题

Q1：两者能否同时使用？

可以，但 maven.test.skip 优先级更高（会覆盖 skipTests 的效果）。例如：

mvn install -Dmaven.test.skip=true -DskipTests=false

最终结果仍是跳过编译和执行。

Q2：如何仅跳过集成测试？

使用 skipITs 属性（需配合 maven-failsafe-plugin）：

mvn verify -DskipITs=true

---

通过理解两者的区别，你可以更精准地控制 Maven 构建过程中的测试行为。