如何通过Maven Profiles在单个pom.xml中指定不同环境配置文件

这问题我之前帮不少开发者解决过，用Maven Profiles来实现多环境配置文件切换其实很直观，我给你一步步拆解怎么做：

1. 在pom.xml中定义环境对应的Profiles #

首先，你需要在pom.xml里为每个环境（test/stage/prod）创建一个Profile，每个Profile里定义一个唯一的环境标识属性，比如env：

<profiles>
    <!-- 测试环境Profile -->
    <profile>
        <id>test</id>
        <properties>
            <env>test</env>
        </properties>
        <!-- 可选：设置默认激活测试环境，这样不指定-P参数时默认用test -->
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>

    <!-- 预发布环境Profile -->
    <profile>
        <id>stage</id>
        <properties>
            <env>stage</env>
        </properties>
    </profile>

    <!-- 生产环境Profile -->
    <profile>
        <id>prod</id>
        <properties>
            <env>prod</env>
        </properties>
    </profile>
</profiles>

2. 配置Maven资源插件，根据Profile加载对应配置文件 #

接下来，使用maven-resources-plugin来根据当前激活的Profile，将对应的.properties文件复制到项目的输出目录（或者重命名为统一的文件名，方便应用加载）。这里推荐重命名成统一的名称（比如application.properties），这样你的代码不需要做任何环境判断，直接加载这个统一文件名即可：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>3.3.1</version> <!-- 建议使用最新稳定版 -->
            <executions>
                <execution>
                    <id>copy-env-properties</id>
                    <phase>process-resources</phase> <!-- 在资源处理阶段执行 -->
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.outputDirectory}</outputDirectory>
                        <resources>
                            <resource>
                                <directory>src/main/resources</directory>
                                <!-- 根据Profile的env属性匹配对应的配置文件 -->
                                <includes>
                                    <include>${env}.properties</include>
                                </includes>
                                <!-- 重命名为统一的application.properties -->
                                <filtering>true</filtering>
                                <targetPath>.</targetPath>
                                <rename>
                                    <from>${env}.properties</from>
                                    <to>application.properties</to>
                                </rename>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

3. 项目结构建议 #

确保你的配置文件放在src/main/resources目录下，结构如下：

src/
└── main/
    └── resources/
        ├── test.properties
        ├── stage.properties
        └── prod.properties

4. 执行命令切换环境 #

现在你只需要通过-P参数指定对应的Profile即可：

• 加载测试环境配置：mvn clean package -Ptest
• 加载预发布环境配置：mvn clean package -Pstage
• 加载生产环境配置：mvn clean package -Pprod

执行后，对应的配置文件会被重命名为application.properties并打包到最终的JAR/WAR中，你的应用直接加载这个文件就可以了。

如果你的应用不需要重命名，只想保留原文件名，那只需要去掉<rename>节点即可，这样对应的test.properties/stage.properties/prod.properties会被直接打包，代码里可以通过读取系统属性或者Maven传递的参数来指定加载哪个文件。

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