JMeter Maven 插件技术文档

1. 安装指南

环境要求

• Maven：版本 >= 3.9.0
• JDK：版本在 8 到 17 之间。如果使用 Java 11，请确保使用较新的版本以避免 JDK-8210005 错误。
• Apache JMeter：默认使用 5.6.2 版本。

安装步骤

1. 在项目的 pom.xml 文件中添加插件依赖：

<plugin>
    <groupId>com.lazerycode.jmeter</groupId>
    <artifactId>jmeter-maven-plugin</artifactId>
    <version>3.8.0</version>
    <executions>
        <!-- 生成 JMeter 配置 -->
        <execution>
            <id>configuration</id>
            <goals>
                <goal>configure</goal>
            </goals>
        </execution>
        <!-- 运行 JMeter 测试 -->
        <execution>
            <id>jmeter-tests</id>
            <goals>
                <goal>jmeter</goal>
            </goals>
        </execution>
        <!-- 测试失败时中断构建 -->
        <execution>
            <id>jmeter-check-results</id>
            <goals>
                <goal>results</goal>
            </goals>
        </execution>
    </executions>
</plugin>

2. 保存 pom.xml 文件后，运行以下命令以确保插件正确安装：

mvn clean install

2. 项目的使用说明

基本使用

1. 添加测试文件：将 JMeter 测试文件（.jmx）放置在项目目录的 src/test/jmeter 文件夹中。插件会自动识别该目录下的所有 .jmx 文件。
2. 运行测试：使用以下命令运行测试：

mvn clean verify

运行 GUI

如果你想通过 GUI 运行 JMeter，可以使用以下命令：

mvn jmeter:configure jmeter:gui

3. 项目API使用文档

插件目标（Goals）

• configure：生成 JMeter 配置。
• jmeter：运行 JMeter 测试。
• results：检查测试结果并在测试失败时中断构建。

配置选项

• jmx 文件路径：默认情况下，插件会自动加载 src/test/jmeter 目录下的所有 .jmx 文件。你可以通过配置指定特定的测试文件。
• csv 数据文件：可以将数据文件放置在 src/test/jmeter 目录下，并在 .jmx 文件中引用这些数据文件。

4. 项目安装方式

Maven 安装

通过在 pom.xml 中添加插件依赖，Maven 会自动下载并安装插件。具体步骤如下：

1. 在 pom.xml 中添加插件配置（如上文所示）。
2. 运行 mvn clean install 命令以确保插件正确安装。

手动安装

如果你需要手动安装插件，可以从 Maven Central 下载插件的 JAR 文件，并将其放置在项目的 lib 目录下。

---

通过以上步骤，你可以轻松地将 JMeter 集成到 Maven 项目中，并使用该插件进行性能测试。