Maven Profile 配置：支持不同环境的构建

1. 什么是 Maven Profile？

Maven Profile 是 Maven 提供的一种环境配置管理机制，可以根据不同的环境（如开发环境、测试环境、生产环境）定义不同的构建配置。

使用场景：

• 多环境配置：如 dev（开发环境）、test（测试环境）、prod（生产环境）。
• 不同的依赖管理：如数据库驱动、日志框架、第三方 API 配置不同。
• 不同的打包方式：如是否包含调试信息、优化参数。
• 不同的服务器配置：如 Tomcat、JBoss、Spring Boot 配置文件。

2. Maven Profile 配置方法

Maven 的 Profile 可以在 pom.xml 或 settings.xml 中定义，并通过命令行 -P 选项激活。

2.1 在 pom.xml 中定义 Profile

在 pom.xml 中，我们可以使用 <profiles> 标签定义多个 Profile，并在 <profile> 内部进行不同的环境配置。

<profiles>
    <profile>
        <id>dev</id> <!-- 开发环境 -->
        <properties>
            <env>development</env>
        </properties>
        <activation>
            <activeByDefault>true</activeByDefault> <!-- 默认启用 -->
        </activation>
    </profile>

    <profile>
        <id>test</id> <!-- 测试环境 -->
        <properties>
            <env>testing</env>
        </properties>
    </profile>

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

2.2 在 settings.xml 中定义 Profile

除了 pom.xml，Maven 还允许在用户目录下的 settings.xml（通常位于 ~/.m2/settings.xml）中定义 Profile。

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <database.url>jdbc:mysql://localhost/devdb</database.url>
        </properties>
    </profile>
</profiles>

注意：在 settings.xml 中定义的 Profile 适用于所有 Maven 项目。

3. Profile 的激活方式

Maven 提供了多种方式来激活 Profile，我们可以手动选择激活 Profile，也可以通过环境变量、操作系统、属性等条件自动激活。

3.1 通过命令行激活

mvn clean package -P dev

这会激活 dev Profile，并执行 clean package 构建流程。

3.2 通过环境变量激活

Maven 允许使用 <activation> 规则，基于环境变量自动启用 Profile。

<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <property>
                <name>env</name>
                <value>dev</value>
            </property>
        </activation>
    </profile>
</profiles>

示例：

mvn clean install -Denv=dev

此时，Maven 会匹配 <property> 里的 env=dev，自动激活 dev Profile。

3.3 通过操作系统激活

<profile>
    <id>windows-profile</id>
    <activation>
        <os>
            <family>Windows</family>
        </os>
    </activation>
</profile>

如果是在 Windows 上运行，则 windows-profile 会自动激活。

3.4 通过 JDK 版本激活

<profile>
    <id>jdk-11</id>
    <activation>
        <jdk>11</jdk>
    </activation>
</profile>

如果当前 JDK 版本是 11，则 jdk-11 Profile 会被自动激活。

4. 在 Profile 中使用不同的依赖

在不同的环境下，可能需要不同的数据库或依赖项。例如：

<profiles>
    <profile>
        <id>dev</id>
        <dependencies>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>8.0.23</version>
            </dependency>
        </dependencies>
    </profile>

    <profile>
        <id>prod</id>
        <dependencies>
            <dependency>
                <groupId>oracle</groupId>
                <artifactId>ojdbc8</artifactId>
                <version>19.8.0.0</version>
            </dependency>
        </dependencies>
    </profile>
</profiles>

在开发环境使用 MySQL，在生产环境使用 Oracle。

使用 -P 指定 Profile：

mvn clean package -P dev

或：

mvn clean package -P prod

5. 在 Profile 中使用不同的构建配置

除了依赖管理，我们还可以在 Profile 中配置不同的构建插件。例如：

<profiles>
    <profile>
        <id>dev</id>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.1</version>
                    <configuration>
                        <debug>true</debug>
                        <fork>true</fork>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>

    <profile>
        <id>prod</id>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.1</version>
                    <configuration>
                        <debug>false</debug>
                        <optimize>true</optimize>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

dev 环境下启用 debug，prod 环境下优化代码，提升性能。

6. Profile 在 CI/CD（持续集成）中的应用

Maven Profile 在 Jenkins、GitLab CI/CD 等自动化构建工具中经常使用。

Jenkins 构建不同环境

在 Jenkins 构建任务中，可以在 Maven Goals 中指定：

clean install -P prod

这样，Jenkins 运行构建时会使用 prod Profile。

GitLab CI/CD 配置

stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - mvn clean package -P dev

deploy:
  stage: deploy
  script:
    - mvn deploy -P prod

在 CI/CD 流水线中，不同的环境使用不同的 Profile。

7. 总结

Maven Profile 是企业级项目中必不可少的工具，它允许我们在 不同环境 之间 灵活切换配置，使得构建过程更加高效、稳定、可维护。🚀