maven环境配置

发表于 2021-09-18 更新于 2025-08-01 分类于 maven Waline：阅读次数：本文字数： 5.7k 阅读时长 ≈ 5 分钟

Maven 环境配置：多环境管理与灵活激活策略

在实际开发中，项目通常需要在本地、开发、测试、生产等多环境中部署，而不同环境的配置（如数据库地址、端口、依赖版本）往往存在差异。Maven 提供了 profile 机制来管理多环境配置，支持灵活的激活方式，确保在不同环境下的构建一致性。本文将详细介绍 Maven 环境配置的实现与最佳实践。

什么是 Maven Profile？

profile 是 Maven 中用于区分环境配置的机制，可在不同环境下启用不同的属性、依赖、插件或构建规则。每个 profile 通过唯一 id 标识，可包含以下内容：

自定义属性（如 profileActive=dev）。
依赖管理（如不同环境引入不同版本的 Jar 包）。
插件配置（如生产环境跳过测试，开发环境启用调试）。
仓库配置（如开发环境使用私服，生产环境使用中央仓库）。

Profile 配置方式

Maven 支持在两个位置配置 profile：项目的 pom.xml 和 全局的 settings.xml，两者适用场景不同。

在 `pom.xml` 中配置（项目级）

适合项目专属的环境配置（如项目特有的数据库地址、端口），配置直接位于项目 pom.xml 的 <profiles> 标签中。

示例：区分本地、开发、测试、生产环境：

<project>
  <!-- 其他配置 ... -->
  
  <profiles>
    <!-- 本地环境 -->
    <profile>
      <id>local</id> <!-- 唯一标识 -->
      <properties>
        <!-- 自定义属性，可在项目中通过 ${profileActive} 引用 -->
        <profileActive>local</profileActive>
        <db.url>jdbc:mysql://localhost:3306/local_db</db.url>
      </properties>
      <activation>
        <!-- 默认激活该环境 -->
        <activeByDefault>true</activeByDefault>
      </activation>
    </profile>

    <!-- 开发环境 -->
    <profile>
      <id>dev</id>
      <properties>
        <profileActive>dev</profileActive>
        <db.url>jdbc:mysql://dev-server:3306/dev_db</db.url>
      </properties>
    </profile>

    <!-- 测试环境 -->
    <profile>
      <id>test</id>
      <properties>
        <profileActive>test</profileActive>
        <db.url>jdbc:mysql://test-server:3306/test_db</db.url>
      </properties>
    </profile>

    <!-- 生产环境 -->
    <profile>
      <id>prod</id>
      <properties>
        <profileActive>prod</profileActive>
        <db.url>jdbc:mysql://prod-server:3306/prod_db</db.url>
      </properties>
      <build>
        <!-- 生产环境打包时跳过测试 -->
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
              <skipTests>true</skipTests>
            </configuration>
          </plugin>
        </plugins>
      </build>
    </profile>
  </profiles>
</project>

特点：

仅对当前项目生效，便于项目内环境隔离。
配置与项目代码一起版本控制，团队成员可共享。

在 `settings.xml` 中配置（全局级）

适合所有项目共享的环境配置（如私服地址、全局代理），配置位于 Maven 全局配置文件 settings.xml（路径：~/.m2/settings.xml 或 MAVEN_HOME/conf/settings.xml）的 <profiles> 标签中。

示例：配置全局私服仓库：

<settings>
  <profiles>
    <profile>
      <id>company-repo</id>
      <!-- 全局仓库配置 -->
      <repositories>
        <repository>
          <id>company-snapshots</id>
          <url>http://nexus.company.com/repository/snapshots/</url>
          <snapshots><enabled>true</enabled></snapshots>
        </repository>
      </repositories>
      <!-- 全局插件仓库 -->
      <pluginRepositories>
        <pluginRepository>
          <id>company-plugins</id>
          <url>http://nexus.company.com/repository/plugins/</url>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>

  <!-- 全局激活该 profile -->
  <activeProfiles>
    <activeProfile>company-repo</activeProfile>
  </activeProfiles>
</settings>

特点：

对本机所有 Maven 项目生效，避免重复配置。
可包含敏感信息（如私服账号），不纳入代码版本控制。

Profile 激活方式

Maven 提供多种激活 profile 的方式，可根据场景灵活选择。

1. 命令行激活（最常用）

通过 -P 参数指定要激活的 profile id，多个环境用逗号分隔。

示例：

# 激活测试环境
mvn clean package -Ptest

# 同时激活开发环境和公司仓库
mvn clean install -Pdev,company-repo

适用场景：CI/CD 流程、临时切换环境。

2. 默认激活（`activeByDefault`）

在 profile 的 <activation> 中配置 <activeByDefault>true</activeByDefault>，当没有其他 profile 被激活时，该 profile 自动生效。

注意：

仅一个 profile 可设置 activeByDefault=true，否则优先级不确定。
若通过命令行激活其他 profile，默认激活的 profile 会被覆盖。

3. 条件激活（基于环境自动触发）

通过 <activation> 标签配置激活条件（如 JDK 版本、操作系统、文件存在性等），满足条件时自动激活。

示例：当 JDK 版本为 1.8 时激活：

<profile>
  <id>jdk8</id>
  <activation>
    <jdk>1.8</jdk> <!-- 匹配 JDK 1.8 -->
  </activation>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
  </properties>
</profile>

其他条件示例：

<activation>
  <!-- 匹配操作系统（如 Windows） -->
  <os>
    <name>Windows</name>
    <family>windows</family>
  </os>
  
  <!-- 当文件存在时激活 -->
  <file>
    <exists>src/main/resources/dev.properties</exists>
  </file>
  
  <!-- 当属性存在时激活（如命令行 -Denv=test） -->
  <property>
    <name>env</name>
    <value>test</value>
  </property>
</activation>

4. 全局激活（`settings.xml` 中配置）

在 settings.xml 的 <activeProfiles> 中指定默认激活的 profile id，对所有项目生效：

<settings>
  <activeProfiles>
    <activeProfile>dev</activeProfile> <!-- 全局默认激活开发环境 -->
    <activeProfile>company-repo</activeProfile>
  </activeProfiles>
</settings>

Profile 实战：多环境配置文件分离

结合 Maven 资源过滤，可实现不同环境使用不同配置文件（如 application-dev.yml、application-prod.yml）。

步骤 1：准备环境配置文件

在 src/main/resources 下创建多环境配置文件：

src/main/resources/
├── application.yml         # 公共配置
├── application-local.yml   # 本地环境配置
├── application-dev.yml     # 开发环境配置
├── application-test.yml    # 测试环境配置
└── application-prod.yml    # 生产环境配置

步骤 2：配置资源过滤

在 pom.xml 中开启资源过滤，根据激活的 profile 替换配置文件中的变量：

<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
      <filtering>true</filtering> <!-- 启用变量过滤 -->
      <includes>
        <include>application.yml</include>
        <!-- 仅包含当前激活环境的配置文件 -->
        <include>application-${profileActive}.yml</include>
      </includes>
    </resource>
  </resources>
</build>

步骤 3：打包时自动选择配置

执行命令时指定环境，Maven 会自动包含对应配置文件：

# 打包生产环境（仅包含 application.yml 和 application-prod.yml）
mvn clean package -Pprod

注意事项与最佳实践

优先级：命令行激活 > settings.xml 全局激活 > pom.xml 默认激活。
敏感信息：生产环境的密码、密钥等敏感信息不应放在 pom.xml 中，建议通过 settings.xml 或环境变量注入。
命名规范：profile id 建议使用 local、dev、test、prod 等统一命名，便于团队理解。
与 Spring Boot 配合：Maven Profile 可与 Spring Boot 的spring.profiles.active结合，实现配置的双重隔离：
```
<properties>
  <spring.profiles.active>${profileActive}</spring.profiles.active>
</properties>
```

打包后application.yml中会自动注入spring.profiles.active=dev（根据激活的环境）。