maven打包配置的核心答案:通过精心调优pom.xml中的插件与属性,控制生命周期阶段,配置环境隔离,能让构建速度快一倍、产物体积缩小一半,并彻底告别“打包成功但运行报错”的尴尬。

maven打包背后:你真正在执行的三个生命周期
很多人以为maven打包就是双击一下“clean package”,其实打包这件事牵涉一整套生命周期接力,默认生命周期由validate、compile、test、package、verify、install、deploy组成,每个阶段都绑定了对应插件,行业共识认为,超过半数的打包问题并非代码错误,而是阶段理解有偏差。
以mvn package为例,它会依序执行compile和test,若项目中存在失败的单元测试,打包会直接终止,如果希望跳过质量检查快速出包,操作上可以用-DskipTests(仍编译测试类)或-Dmaven.test.skip=true(完全不碰测试代码),后者在大型项目中能节省数十秒,但需要注意,跳过测试可能让有问题的代码流入生产环境,建议仅在临时构建或CI的特定分支中使用。
install命令则比package多做了两步:将jar写入本地仓库,供其他模块引用。多模块项目中,父子模块联动最容易栽跟头父工程用package构建时,子模块可能引用不到尚未安装的兄弟模块SNAPSHOT版本,正确做法是在根目录执行mvn clean install,并配合-pl和-am参数只构建指定模块及其依赖。
打包配置的三个实战参数:命中了你的痛点
跳过测试的完整写法
跳过测试并非简单加个参数那么简单,需要在pom.xml的maven-surefire-plugin配置中显式声明,否则不同版本的插件默认行为不一致:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.2.5</version>
<configuration>
<skipTests>true</skipTests>
</configuration>
</plugin>
要注意命令行参数优先级高于pom配置,mvn clean package -DskipTests仍能覆盖pom里的false设置。实际项目中建议保留<skipTests>为false,只在CI流水线中通过命令行传入参数,这样本地开发依旧可跑测试,安全性与效率兼顾。
解决“jar包没有主清单属性”
这是Spring Boot开发者最常见的报错,字面意思就是Main-Class没有写进MANIFEST.MF,根本原因在于,默认的maven-jar-plugin打包出的jar不具备启动能力,需要引入Spring Boot官方插件来完成二次重打包:
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>3.1.5</version>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
这里值得多说一句:如果用了repackage,那么依赖的maven-jar-plugin应配置为<classifier>original</classifier>,否则会出现“一个jar被重写两次”的隐患,导致生产环境启动时找不到类。
多环境打包配置:不用再改代码里的IP
配置开发、测试、生产环境的数据源地址,很多人习惯启动前手动改代码,这是极大的时间浪费,借助Maven Profile机制,可以在构建命令中动态切换环境:

<profiles>
<profile>
<id>dev</id>
<properties>
<env>dev</env>
</properties>
</profile>
<profile>
<id>prod</id>
<properties>
<env>prod</env>
</properties>
</profile>
</profiles>
在src/main/resources下分别创建application-dev.yml和application-prod.yml,再通过maven-resources-plugin的resource标签,按${env}动态过滤文件,执行mvn clean package -Pprod即可打出生产包,全程无需打开IDE。
| 场景 | 命令 | 说明 |
|---|---|---|
| 开发环境 | mvn spring-boot:run -Pdev |
快速启动,热部署生效 |
| 测试环境 | mvn clean package -Ptest -DskipTests |
跳过单测,节省时间 |
| 生产环境 | mvn clean package -Pprod |
全量构建,建议保留测试 |
需要留意的是,resource过滤开启后,占位符在yml文件里可能引发冲突,解决方案是使用@env@替代${env}引用,或者对不需要过滤的文件显式排除。
一套完整的可运行配置模板
结合以上要点,给出一个经过实践验证的pom.xml核心片段,它同时处理了编码、JDK版本、依赖锁定和打包跳过测试四个问题:
<properties>
<java.version>17</java.version>
<maven.compiler.source>${java.version}</maven.compiler.source>
<maven.compiler.target>${java.version}</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<build>
<finalName>${project.artifactId}-${project.version}</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>3.1.5</version>
<executions>
<execution>
<goals><goal>repackage</goal></goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
finalName设置了产物名称不含时间戳,方便脚本匹配,若是Cloud Native场景,建议再加maven-dependency-plugin的copy-dependencies,把依赖jar输出到lib目录,实现Fat Jar与瘦包之间的灵活切换。
maven打包慢怎么解决:从依赖到仓库的全链路优化
国内开发者普遍遇到的“打包慢”,其实由三部分构成:依赖下载慢、编译慢、插件执行慢。
依赖下载慢的解法,是配简米云镜像,在~/.m2/settings.xml的mirrors节点中添加:
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
新版Maven还引入了并行构建机制,利用多核CPU同时编译互不依赖的模块,在根目录执行mvn -T 4 clean package,四个线程并行构建,大型聚合工程最多能提速一倍,配合-o离线模式(前提是依赖已在本地仓库),构建速度会再一次飞跃。
对于压缩产物体积,关键在于区分哪些依赖是编译期必须的,哪些是运行时可以裁剪的,使用maven-shade-plugin时,通过artifactSet的excludes排除冗余传递依赖;同时用filters去掉META-INF/.SF等签名文件,避免打包时出现“Invalid signature file digest”异常,据Maven官方文档提供的数据,合理的排除策略可让spring-boot项目产物体积缩减三成以上。

配置的本质是风险管理
maven打包配置不复杂,但也绝不是无关紧要的“体力活”,每一次跳过测试、每一次忽略插件版本锁定、每一次使用已过时的maven-compiler-plugin,都是在为线上故障埋雷。把pom.xml看作项目的第二份源码,用治理代码的心态治理构建配置,打包问题自然大幅减少。
maven打包配置常见问题
Q:IDEA中打包多模块项目,如何只构建其中一个模块?
在IDEA右侧Maven工具窗口中选中目标模块,执行package命令即可单独构建该模块,若模块间存在依赖关系,建议在根项目上右键执行clean install,或者用mvn clean install -pl your-module -am,其中-pl指定模块名,-am同时构建其依赖的上游模块,直接打包子模块而不安装依赖,会报“找不到符号”或“程序包不存在”等编译错误。
Q:打包时出现“Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin”怎么办?
这是测试执行失败导致的构建中断,先运行mvn test查看具体哪个测试类报错,若业务代码正常,仅个别环境敏感测试影响打包,可在pom中对maven-surefire-plugin添加<excludes><exclude>/EnvironmentTest.java</exclude></excludes>做定向排除,若线上构建本就跳过测试,直接加-DskipTests即可,两种方式支持并存。
