Maven 不同环境灵活构建的步骤

更新时间：2024年10月27日 09:30:12 作者：知楠行易

在项目开发过程中,合理地使用Maven管理不同的构建环境（开发、测试、生产）是提高项目管理效率和应对复杂项目需求的关键,本文就来介绍一下Maven 不同环境灵活构建的步骤,感兴趣的可以了解一下

一、项目分层

一般的初创项目不会有特别多的配置文件，所以使用 spring.profiles.active就可以满足需求，但伴随项目规模扩大，引入的依赖/中间件越多，配置文件越多，仅仅靠单一的文件无法满足，可以参考下面的结构：

├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── github
│   │   └── resources
│   │       ├── resources-env
│   │       │   ├── dev
│   │       │   └── prod
│   │       └── static

1. 使用 Maven 配置不同环境

在 Maven 中，<profiles> 是一个非常强大的功能，它允许你根据不同的构建环境（如开发、测试、生产）来定义不同的配置。在 pom.xml 文件中使用 <profiles>，可以对插件、依赖、属性等进行差异化配置，进而实现灵活的构建管理。

1.1 配置不同的环境

pom.xml配置如下：

<profiles>
  <!-- 本地开发 -->
  <profile>
    <id>dev</id>
    <properties>
      <env>dev</env>
    </properties>
    <activation>
      <activeByDefault>true</activeByDefault> <!-- 默认使用 dev -->
    </activation>
  </profile>
  <!-- 测试 -->
  <profile>
    <id>test</id>
    <properties>
      <env>test</env>
    </properties>
  </profile>
  <!-- 预发 -->
  <profile>
    <id>pre</id>
    <properties>
      <env>pre</env>
    </properties>
  </profile>
  <!-- 生产 -->
  <profile>
    <id>prod</id>
    <properties>
      <env>prod</env>
    </properties>
  </profile>
</profiles>

1.2 配置构建信息

pom.xml文件如下：

 <build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/resources/resources-env/${env}</directory>
            <filtering>true</filtering> <!-- 启用资源过滤 -->
        </resource>
    </resources>

   
    <plugins>
      <!--     spring 配置文件可以使用占位符读取pom.xml中的变量 例如 @env@       -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <delimiters>
                    <delimiter>@</delimiter>
                </delimiters>
                <useDefaultDelimiters>false</useDefaultDelimiters>
            </configuration>
        </plugin>
    </plugins>

 </build>

1.3 Spring 配置文件激活不同环境的配置文件

application.properties 文件配置如下：

spring.profiles.active=@env@

1.4 构建项目

命令参考：

mvn clean package -Pprod

二、可能遇到的问题

2.1 IDEA直接启动项目，读取不到环境配置文件

项目环境变量设置有问题。

解决方法：
IDEA 操作 File -> Project Structure -> Modules 设置 Resources 就可以了

在这里插入图片描述

2.2 启动项目，报错：IOException: DerInputStream.getLength()

错误原因是因为 <filtering>true</filtering> 会进行文件过滤，非纯文本文件（例如.p12二进制文件）需要进一步配置。

参考：https://www.jb51.net/program/3294793jy.htm

2.3 Maven 打包缺少环境配置文件

Spring 项目配置文件位置：

默认 src/main/resources 目录下的文件
config 子目录下的配置文件

打包时需要进一步处理。

参考：进一步的，打包时时可以进一步优化，即开发环境，构建时只将测试资源文件打包到应用中，进一步提升项目的安全性。

 <!--    打包时将 将不同环境的配置文件复制到jar包中        -->
 <plugin>
     <groupId>org.apache.maven.plugins</groupId>
     <artifactId>maven-resources-plugin</artifactId>
     <version>3.2.0</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/resources-env/${env}</directory>
                         <filtering>false</filtering>
                     </resource>
                 </resources>
             </configuration>
         </execution>
     </executions>
 </plugin>

<plugin>
   <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.2.0</version>
    <configuration>
       	<!-- 环境隔离 排除不需要的文件-->
        <excludes>
            <exclude>resources-env/**</exclude>
        </excludes>
    </configuration>
</plugin>

三、进一步优化

3.1 缩小应用jar包的体积

伴随项目依赖越来越大，应用jar包的体积会越来越大，可以进一步优化。

参考：优化依赖打包

到此这篇关于Maven 不同环境灵活构建的步骤的文章就介绍到这了,更多相关Maven 不同环境构建内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

使用maven的profile构建不同环境配置的方法

Springboot引用外部配置文件的方法步骤
这篇文章主要介绍了Springboot引用外部配置文件的方法步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-04-04
Spring IOC核心原理详解与运用实战教程
本文详细解析了Spring IOC容器的核心原理,包括BeanFactory体系、依赖注入机制、循环依赖解决和三级缓存机制,同时,介绍了Spring Boot中IOC的应用,包括自动配置、Bean作用域管理、配置方式演进以及Bean创建过程的完整剖析,感兴趣的朋友一起学习吧
2025-11-11
慢sql提前分析预警和动态sql替换-Mybatis-SQL
为防止慢SQL问题而开发的MyBatis组件,该组件能够在开发、测试阶段自动分析SQL语句,并在出现慢SQL问题时通过Ducc配置实现动态替换,从而快速止损
2025-05-05
Flowable ReceiveTask使用场景分析
这篇文章主要为大家介绍了Flowable ReceiveTask使用场景分析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-10-10
Spring Boot中自动执行sql脚本的方法实例
在SpringBoot的架构中,DataSourceInitializer类可以在项目启动后初始化数据,我们可以通过自动执行自定义sql脚本初始化数据,下面这篇文章主要给大家介绍了关于Spring Boot中自动执行sql脚本的相关资料,需要的朋友可以参考下
2022-01-01
在Java中FreeMarker 模板来定义字符串模板
这篇文章主要介绍了在Java中FreeMarker 模板来定义字符串模板，文章基于Java的相关资料展开详细内容，需要的小伙伴可以参考一下
2022-04-04
hibernate5.2的基本配置方法(详解)
下面小编就为大家带来一篇hibernate5.2的基本配置方法(详解)。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-06-06
Java基础题新手练习(二)
下面小编就为大家带来一篇Java基础的几道练习题(分享)。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧，希望可以帮到你
2021-07-07
IDEA项目如何实现打jar包
这篇文章主要介绍了IDEA项目如何实现打jar包问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
如何解决Webservice第一次访问特别慢的问题
这篇文章主要介绍了如何解决Webservice第一次访问特别慢的问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-06-06