Maven 不同环境灵活构建

需求:
使用 Maven根据不同的构建环境（如开发、测试、生产）来定义不同的配置，实现灵活的构建管理。
需要Demo项目的可以参考：我的demo项目

一、项目分层

一般的初创项目不会有特别多的配置文件，所以使用 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二进制文件）需要进一步配置。

参考：解决方案

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

Spring 项目配置文件位置：

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

打包时需要进一步处理。

参考：解决方案

三、进一步优化

3.1 缩小应用jar包的体积

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

参考：优化依赖打包