使用Maven运行JMeter测试时遭遇未知生命周期错误求助

尝试通过Maven运行JMeter脚本，POM.xml配置无明显问题，但执行本地Maven命令时触发未知生命周期错误，直接在JMeter中运行jmx文件则正常。

执行的Maven命令 #

mvn clean verify -e -Dtest.testcasename=Security4 -Dtest.environment=AllTests -Dtest.product=AllAPIs

错误信息 #

[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  0.489 s
[INFO] Finished at: 2023-10-19T12:15:32-04:00
[INFO] ------------------------------------------------------------------------
[ERROR] Unknown lifecycle phase ".testcasename=Security4". You must specify a valid lifecycle phase or a goal in the format <plugin-prefix>:<goal> or <plugin-group-id>:<plugin-artifact-id>[:<plugin-version>]:<goal>. Available lifecycle phases are: validate, initialize, generate-sources, process-sources, generate-resources, process-resources, compile, process-classes, generate-test-sources, process-test-sources, generate-test-resources, process-test-resources, test-compile, process-test-classes, test, prepare-package, package, pre-integration-test, integration-test, post-integration-test, verify, install, deploy, pre-clean, clean, post-clean, pre-site, site, post-site, site-deploy. -> [Help 1]
org.apache.maven.lifecycle.LifecyclePhaseNotFoundException: Unknown lifecycle phase ".testcasename=Security4". You must specify a valid lifecycle phase or a goal 

POM.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>

<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.mycompany.app</groupId>

    <artifactId>Service</artifactId>

    <packaging>jar</packaging>

    <version>1.0-SNAPSHOT</version>

    <name>DPHTest</name>

    <description>This application contains the Jmeter Service Tests for my app.</description>

 
    <properties>
        <Environment>${test.environment}</Environment>
        <!--<Region>${test.region}</Region>-->
        <Server>${test.server}</Server>
        <Product>${test.product}</Product>
        <TestCaseName>${test.testcasename}</TestCaseName>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

 
    <dependencies>
        <!-- https://mvnrepository.com/artifact/junit/junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

 
    <build>
        <plugins>
            <plugin>
                <groupId>com.lazerycode.jmeter</groupId>
                <artifactId>jmeter-maven-plugin</artifactId>
                <version>3.5.0</version>
                <executions>
                    <!-- Generate JMeter configuration -->
                    <execution>
                        <id>configuration</id>
                        <goals>
                            <goal>configure</goal>
                        </goals>
                    </execution>    
                    <!-- Run JMeter tests -->
                    <execution>
                        <id>jmeter-tests</id>
                        <goals>
                            <goal>jmeter</goal>
                        </goals>
                    </execution>
                    <!-- Fail build on errors in test -->
                    <execution>
                        <id>jmeter-check-results</id>
                        <goals>
                            <goal>results</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <jmeterVersion>5.4.3</jmeterVersion>
                    <testPlanLibraries>
                        <artifact>org.apache.logging.log4j:log4j-core:2.17.0</artifact>
                    </testPlanLibraries>
                    <failBuildIfResultFileIsEmpty>false</failBuildIfResultFileIsEmpty>
                    <testFilesIncluded>
                        <!-- <jMeterTestFile>Security4.jmx</jMeterTestFile>   -->
                        <jMeterTestFile>${testcasename}.jmx</jMeterTestFile>
                    </testFilesIncluded>
                    <ignoreResultFailures>false</ignoreResultFailures>
                    <appendResultsTimestamp>true</appendResultsTimestamp>
                    <resultsFileFormat>csv</resultsFileFormat>
                    <generateReports>true</generateReports>
                    <reportConfig>
                    </reportConfig>
                    <!-- change protocol, server and port of tested API/web Application  -->
                    <propertiesUser>
                        <csvSource>${basedir}/src/test/resources</csvSource>
                        <!--<Server>${server}</Server>-->
                        <zap.host>${zap.server}</zap.host>
                        <environment>${Environment}</environment>
                        <!-- <region>${Region}</region> -->
                        <product>${Product}</product>
                        <!--<testcasename>${TestCaseName}</testcasename>-->
                        <targetResults>${basedir}/target/jmeter/results</targetResults>
                        <!--  <Port>${port}</Port> -->
                        <zap.port>${zap.port}</zap.port>
                    </propertiesUser>
                    <propertiesJMeter>
                        <log_level.jmeter>DEBUG</log_level.jmeter>
                        <jmeter.save.saveservice.response_data>true</jmeter.save.saveservice.response_data>
                        <jmeter.save.saveservice.url>true</jmeter.save.saveservice.url>
                    </propertiesJMeter>
                </configuration>    
               
            </plugin>
        </plugins>
    </build>

</project>

问题排查与解决 #

1. 核心错误原因：Maven参数解析失败 #

错误提示Unknown lifecycle phase ".testcasename=Security4"，说明Maven将.testcasename=Security4识别为了生命周期阶段，而非系统属性的一部分。这通常是因为命令中-D参数与前面的选项之间缺少空格，例如-e-Dtest.testcasename=...这种写法会导致Maven无法正确解析-D参数，将-e-Dtest视为一个选项，剩余的.testcasename=Security4被当成生命周期阶段。

解决方法：确保每个-D参数前面都有完整的空格，修正后的命令应为：

mvn clean verify -e -Dtest.testcasename=Security4 -Dtest.environment=AllTests -Dtest.product=AllAPIs

（注：检查命令输入时是否存在空格丢失或特殊字符转义问题，比如复制粘贴时的格式错误）

2. POM配置的潜在问题 #

即使解决了命令参数问题，当前POM还存在一个变量匹配错误：

• 在<testFilesIncluded>中使用了${testcasename}.jmx，但Maven属性中定义的是TestCaseName（映射自${test.testcasename}），此处应改为${TestCaseName}.jmx，否则Maven无法找到对应的jmx文件。

修正后的<testFilesIncluded>部分：

<testFilesIncluded>
    <!-- <jMeterTestFile>Security4.jmx</jMeterTestFile>   -->
    <jMeterTestFile>${TestCaseName}.jmx</jMeterTestFile>
</testFilesIncluded>

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