如何为Maven Surefire按环境配置多套环境变量适配Bamboo构建

解决这个问题最优雅的方式是利用Maven Profiles来定义不同环境的变量集合，然后通过命令行参数激活对应环境，完全避免在命令行传递大量变量。下面是具体的实现步骤：

1. 优化Pom.xml配置：使用Profiles管理多环境变量 #

首先，我们可以在pom.xml中定义对应测试环境、生产环境的Profiles，每个Profile包含该环境专属的变量值，同时统一配置Surefire插件引用这些变量。为了避免重复代码，推荐先在pluginManagement中统一配置Surefire插件的结构，然后在Profiles中仅覆盖变量值：

<project>
  <!-- 可选：定义默认变量值作为降级方案 -->
  <properties>
    <app.host>default.example.com</app.host>
    <app.port>8080</app.port>
    <!-- 这里添加所有需要的环境变量默认值 -->
  </properties>

  <build>
    <!-- 统一管理Surefire插件配置，避免重复编写 -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.21.0</version>
          <configuration>
            <environmentVariables>
              <!-- 将Maven属性映射为测试时的环境变量 -->
              <APP_HOST>${app.host}</APP_HOST>
              <APP_PORT>${app.port}</APP_PORT>
              <!-- 这里添加所有需要传递给测试的环境变量，一一对应 -->
            </environmentVariables>
          </configuration>
        </plugin>
      </plugins>
    </pluginManagement>

    <!-- 确保插件生效 -->
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

  <!-- 定义多环境Profiles -->
  <profiles>
    <!-- 测试环境Profile -->
    <profile>
      <id>test-env</id>
      <!-- 通过-Denv=test自动激活这个Profile -->
      <activation>
        <property>
          <name>env</name>
          <value>test</value>
        </property>
      </activation>
      <properties>
        <app.host>test-server-ip</app.host>
        <app.port>9090</app.port>
        <!-- 覆盖测试环境的所有变量值 -->
      </properties>
    </profile>

    <!-- 生产环境Profile -->
    <profile>
      <id>prod-env</id>
      <!-- 通过-Denv=prod自动激活这个Profile -->
      <activation>
        <property>
          <name>env</name>
          <value>prod</value>
        </property>
      </activation>
      <properties>
        <app.host>prod-server-ip</app.host>
        <app.port>80</app.port>
        <!-- 覆盖生产环境的所有变量值 -->
      </properties>
    </profile>
  </profiles>
</project>

2. 命令行执行方式 #

现在你只需要通过简单的命令参数就能切换环境：

• 执行测试环境的测试：

  mvn clean test -Denv=test
  

• 执行生产环境的测试：

  mvn clean test -Denv=prod
  

Maven会自动根据-Denv参数激活对应的Profile，Profile中的变量会覆盖默认值，最终传递给Surefire插件作为测试的环境变量。

3. Bamboo构建计划适配 #

在Bamboo中，你只需要给不同的构建计划配置对应的Maven命令即可：

• 测试环境的构建计划：任务执行命令mvn clean test -Denv=test
• 生产环境的构建计划：任务执行命令mvn clean test -Denv=prod

完全不需要在命令行中传递十几个变量，简洁又易维护。

备选方案：外部属性文件（适合超大量变量） #

如果你的环境变量数量特别多（比如几十个），可以把变量放到外部属性文件中，进一步简化pom.xml：

1. 在项目目录下创建src/main/filters/test.properties和src/main/filters/prod.properties，内容类似：

   app.host=test-server-ip
   app.port=9090
   

2. 在Profile中配置加载对应属性文件：

   <profile>
     <id>test-env</id>
     <activation>
       <property>
         <name>env</name>
         <value>test</value>
       </property>
     </activation>
     <build>
       <filters>
         <filter>src/main/filters/${env}.properties</filter>
       </filters>
     </build>
   </profile>
   

这样变量的维护完全脱离pom.xml，更适合大规模的环境配置。

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