2. 搭建Maven工程并配置JUnit4依赖

在开始实现自定义 TestRule 之前，必须搭建一个标准化的Maven工程并正确引入JUnit4依赖。Maven提供了依赖管理、构建生命周期和测试执行框架，是Java测试工程的最佳实践起点。本章将详细讲解从零搭建Maven工程并配置JUnit4的全过程。

2.1 为什么选择Maven + JUnit4

Maven与JUnit4的组合是现代Java测试的经典选择。Maven通过约定优于配置原则自动管理测试目录结构、依赖传递和执行流程，而JUnit4提供了灵活的扩展点（如TestRule）用于自定义夹具逻辑。以下表格对比了常见构建工具与测试框架的组合优劣：

2.2 创建标准Maven工程

Maven工程的目录结构必须遵循Standard Directory Layout约定。使用以下命令在终端中创建基本工程骨架：

mvn archetype:generate \
    -DgroupId=com.example.testrule \
    -DartifactId=testrule-demo \
    -DarchetypeGroupId=org.apache.maven.archetypes \
    -DarchetypeArtifactId=maven-archetype-quickstart \
    -DarchetypeVersion=1.4 \
    -DinteractiveMode=false

执行成功后，会在当前目录下生成testrule-demo文件夹，包含以下核心目录结构：

testrule-demo/
├── pom.xml
├── src/
│   ├── main/
│   │   └── java/
│   │       └── com/example/testrule/
│   │           └── App.java
│   └── test/
│       └── java/
│           └── com/example/testrule/
│               └── AppTest.java

这个结构已经满足基本测试需求，但为了TestRule实战课程，我们还需要添加测试资源目录和自定义Rule包路径，完整的目录结构应该如下：

testrule-demo/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/testrule/
│   │   │       ├── App.java                # 主业务类
│   │   │       └── rule/
│   │   │           └── CustomRule.java      # 自定义TestRule（后续章节实现）
│   │   └── resources/
│   │       └── application.properties       # 主配置文件
│   └── test/
│       ├── java/
│       │   └── com/example/testrule/
│       │       ├── AppTest.java             # 基础测试类
│       │       └── rule/
│       │           └── CustomRuleTest.java  # 针对Rule的单元测试（后续章节）
│       └── resources/
│           └── test-data.properties         # 测试专用配置文件

2.3 配置pom.xml：引入JUnit4依赖

在pom.xml中添加JUnit4核心依赖和Maven Surefire插件的完整配置。以下配置同时包含了依赖版本管理和插件执行参数：

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example.testrule</groupId>
    <artifactId>testrule-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <!-- 统一版本管理 -->
    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <junit.version>4.13.2</junit.version>
        <surefire.version>3.0.0-M7</surefire.version>
    </properties>

    <dependencies>
        <!-- JUnit4 核心依赖 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
            <scope>test</scope>
        </dependency>
        <!-- 可选：Hamcrest匹配器，增强断言可读性 -->
        <dependency>
            <groupId>org.hamcrest</groupId>
            <artifactId>hamcrest-all</artifactId>
            <version>1.3</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!-- Maven Surefire 插件：控制测试执行 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>${surefire.version}</version>
                <configuration>
                    <!-- 包含所有以 Test 结尾的测试类 -->
                    <includes>
                        <include>**/*Test.java</include>
                        <include>**/*Tests.java</include>
                    </includes>
                    <!-- 排除内部类和抽象类 -->
                    <excludes>
                        <exclude>**/Abstract*.java</exclude>
                        <exclude>**/*$*.java</exclude>
                    </excludes>
                    <!-- 控制测试报告输出编码 -->
                    <encoding>UTF-8</encoding>
                    <!-- 开启并行执行（可选） -->
                    <parallel>classes</parallel>
                    <useUnlimitedThreads>true</useUnlimitedThreads>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

2.4 Maven Surefire插件深度配置

Surefire插件是Maven执行JUnit测试的核心引擎。除了基本的包含/排除规则外，以下参数对TestRule实战尤其重要：

在pom.xml的<configuration>块中，可以通过以下方式添加forkCount和failIfNoTests：

<configuration>
    <forkCount>1</forkCount>
    <reuseForks>true</reuseForks>
    <failIfNoTests>false</failIfNoTests>
    <reportFormat>brief</reportFormat>
    <!-- 其他配置如上节 -->
</configuration>

2.5 验证工程配置

完成pom.xml配置和目录结构调整后，执行以下命令验证工程配置是否正确：

# 进入工程根目录
cd testrule-demo

# 下载依赖并编译所有代码
mvn clean compile

# 运行所有测试类
mvn clean test

# 查看Surefire插件是否正常工作
mvn surefire:test

如果配置正确，终端会输出类似以下内容（没有测试失败）：

[INFO] Scanning for projects...
[INFO] --------------------< com.example.testrule:testrule-demo >--------------------
[INFO] Building testrule-demo 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ testrule-demo ---
[INFO] 
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ testrule-demo ---
[INFO] 
[INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ testrule-demo ---
[INFO] 
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ testrule-demo ---
[INFO] 
[INFO] --- maven-compiler-plugin:3.8.0:testCompile (default-testCompile) @ testrule-demo ---
[INFO] 
[INFO] --- maven-surefire-plugin:3.0.0-M7:test (default-test) @ testrule-demo ---
[INFO] 
[INFO] -------------------------------------------------------
[INFO]  T E S T S
[INFO] -------------------------------------------------------
[INFO] Running com.example.testrule.AppTest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.023 s
[INFO] 
[INFO] Results:
[INFO] 
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

2.6 Maven工程搭建流程SVG

2.7 常见错误与调试

在搭建工程过程中，开发者常遇到以下三类典型问题：

• 依赖下载失败：Maven无法从中央仓库下载JUnit4或Surefire插件。解决方案：检查settings.xml中的镜像配置，或手动指定仓库URL。
• 测试类未被识别：Surefire报告Tests run: 0。通常原因是测试类名不符合*Test.java模式，或者测试类被放在了src/main目录下。
• JUnit版本冲突：项目同时依赖了JUnit4和JUnit5，导致运行时报错No tests found。排查方法：使用mvn dependency:tree检查依赖树，排除多余版本。

# 调试命令示例
mvn test -X | grep -E "surefire|test|include|exclude"

2.8 性能优化建议

对于大型测试套件，合理的Surefire配置能显著提升执行效率：

<!-- 完整的性能优化配置片段 -->
<configuration>
    <parallel>classes</parallel>
    <useUnlimitedThreads>true</useUnlimitedThreads>
    <disableXmlReport>false</disableXmlReport>
    <argLine>-Xmx512m -XX:+UseG1GC</argLine>
    <includes>
        <include>**/*Test.java</include>
    </includes>
</configuration>