TestNG项目：如何通过Maven外部参数替换application.properties配置？

我专门做过类似的TestNG项目配置，下面给你一步步拆解实现方法，用到的核心插件是Maven Resources Plugin，它能帮咱们完成资源文件的参数替换工作。

一、核心插件说明 #

Maven Resources Plugin是Maven原生的资源处理插件，支持在构建过程中对资源文件（比如application.properties）进行变量替换，完美适配咱们从命令行或POM传入外部参数的需求。

二、具体实现步骤 #

1. 配置POM.xml中的资源插件 #

在pom.xml的<build>节点下添加以下配置，开启资源过滤并指定要处理的文件：

<build>
    <!-- 定义可外部传入的参数，也可以直接通过命令行传入，这里只是设置默认值 -->
    <properties>
        <app.base.url>http://default.example.com</app.base.url>
        <app.env>test</app.env>
    </properties>

    <resources>
        <resource>
            <!-- 指定资源文件所在目录 -->
            <directory>src/main/resources</directory>
            <!-- 开启变量过滤功能 -->
            <filtering>true</filtering>
            <!-- 指定要处理的目标文件，这里只针对application.properties -->
            <includes>
                <include>application.properties</include>
            </includes>
        </resource>
    </resources>

    <!-- 配置Resources插件，确保过滤逻辑在构建阶段生效 -->
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>3.3.1</version>
            <executions>
                <execution>
                    <id>copy-resources</id>
                    <phase>process-resources</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.outputDirectory}</outputDirectory>
                        <resources>
                            <resource>
                                <directory>src/main/resources</directory>
                                <filtering>true</filtering>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 修改application.properties文件 #

把需要替换的内容用${参数名}的格式标记，示例如下：

# 这些变量会在Maven构建时被外部传入的参数替换
app.base.url=${app.base.url}
app.environment=${app.env}
app.timeout=3000

3. TestNG中读取替换后的参数 #

在TestNG测试类里，你可以通过Properties类读取替换后的application.properties，或者直接读取系统属性（Maven会把传入的参数注入到系统属性中）：

import org.testng.annotations.BeforeClass;
import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;

public class BaseTest {
    private Properties properties;

    @BeforeClass
    public void loadProperties() throws IOException {
        properties = new Properties();
        // 读取target目录下已经完成替换的properties文件
        InputStream inputStream = getClass().getClassLoader().getResourceAsStream("application.properties");
        properties.load(inputStream);
        
        // 也可以直接读取系统属性（命令行传入的参数会被Maven设置为系统属性）
        String baseUrl = System.getProperty("app.base.url");
        System.out.println("从系统属性获取的Base URL: " + baseUrl);
    }

    public String getProperty(String key) {
        return properties.getProperty(key);
    }
}

4. 运行项目时传入外部参数 #

执行Maven测试命令时，通过-D参数名=值的方式传入外部参数，比如：

mvn clean test -Dapp.base.url=http://prod.example.com -Dapp.env=production

这样构建过程中，Maven会自动把application.properties里的${app.base.url}和${app.env}替换成你传入的值。

三、注意事项 #

• 要确保src/main/resources目录在你的项目结构中存在，并且application.properties放在这个目录下。
• 如果你的TestNG测试用到了src/test/resources目录的资源文件，那在POM的<build>节点下也要配置对应的<testResources>节点，开启过滤功能。
• 建议使用Maven Resources Plugin的最新稳定版，避免出现兼容性问题。

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