Spring Boot项目打包WAR时Maven构建报错解决方案咨询

这个错误的核心原因是：Maven执行mvn clean install时，Spring初始化上下文需要解析${env}占位符，但这个参数没有被传递到Maven构建进程中。毕竟你通过VM参数传的-Denv=dev如果没给到Maven，Spring自然找不到这个变量。下面是几种实用的解决方式：

1. 直接在Maven命令中传递参数 #

最简单的办法就是在执行Maven命令时直接带上-Denv=dev参数，让Maven进程能拿到这个值，这样Spring在构建过程中就能正确解析占位符了：

mvn clean install -Denv=dev

如果是在IDE（比如IDEA、Eclipse）里运行Maven命令，记得在Maven运行配置的「Command line」里加上这个参数，或者在「VM options」里添加-Denv=dev。

2. 配置Maven Profile（更规范的多环境管理方式） #

如果经常在不同环境切换打包，推荐用Maven Profile来管理环境参数，避免每次手动输入参数：

1. 在你的pom.xml中添加Profile配置：

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <env>dev</env>
        </properties>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <env>prod</env>
        </properties>
    </profile>
</profiles>

2. 打包时指定对应的Profile即可：

# 打包开发环境
mvn clean install -Pdev

# 打包生产环境
mvn clean install -Pprod

这种方式不仅能统一管理环境参数，还能在Profile里配置更多环境相关的构建逻辑，比如不同的依赖、资源过滤规则等。

3. 调整Spring Boot Maven插件配置，避免构建时初始化上下文 #

如果你的打包过程不需要启动Spring应用上下文（只是单纯打包WAR），可以配置spring-boot-maven-plugin跳过应用启动步骤，这样就不会触发占位符解析了：
在pom.xml的build/plugins里添加：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <!-- 跳过打包时的应用启动验证 -->
        <skip>true</skip>
    </configuration>
</plugin>

不过这种方式要注意：如果你的项目有构建时需要执行的Spring相关逻辑（比如生成代码、校验配置），可能会影响这些步骤，所以按需使用。

4. 改用Spring Boot原生多环境配置（推荐最佳实践） #

其实Spring Boot本身就支持多环境配置的原生方案，你可以把配置文件命名为application-dev.properties、application-prod.properties，然后通过spring.profiles.active指定环境，这样就不用手动拼接endpoints-${env}.properties这种路径了：

• 启动或打包时通过参数指定：mvn clean install -Dspring.profiles.active=dev
• 或者在application.properties里默认指定：spring.profiles.active=dev

这种方式更贴合Spring Boot的设计思路，也能避免手动占位符解析带来的问题。

内容的提问来源于stack exchange，提问作者Oscar Reynaldo Flores Jiménez