Forest Hu1. Spring Boot项目打包的本质与价值
在Java开发领域，打包部署是项目从开发环境走向生产环境的必经之路。Spring Boot作为当下最流行的Java应用框架，其打包机制与传统Java Web项目有着显著差异。我曾经历过一个典型场景：团队将一个传统Spring MVC项目迁移到Spring Boot时，由于对打包机制理解不透彻，导致部署后出现静态资源404错误，耗费两天才定位到是打包策略配置不当所致。
Spring Boot的打包设计遵循"约定优于配置"原则，默认提供两种打包方式：
- 可执行JAR：内嵌Tomcat/Jetty等Servlet容器，通过
java -jar命令直接运行 - 传统WAR：需要部署到外部Tomcat等应用服务器
这两种方式并非简单二选一，而是面向不同场景的技术方案。理解它们的底层差异，才能避免"本地运行正常，部署就报错"的经典问题。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 项目打包配置全流程解析
2.1 基础环境搭建
在开始打包前，需要确保开发环境满足以下条件（以当前主流版本为例）：
xml复制<!-- pom.xml基础配置 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.1.5</version>
</parent>
<java.version>17</java.version>
<packaging>jar</packaging> <!-- 默认打包类型 -->
关键提示：JDK版本必须与Spring Boot版本匹配。例如Spring Boot 3.x需要JDK17+，这是许多初学者容易忽略的兼容性问题。
2.2 JAR包打包深度配置
2.2.1 标准可执行JAR配置
xml复制<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>
这段配置实现了：
- 使用spring-boot-maven-plugin插件（核心）
- 排除开发阶段依赖（如lombok）减小包体积
- 生成的可执行JAR包含三层结构：
- BOOT-INF/classes：应用类文件
- BOOT-INF/lib：依赖库
- META-INF：MANIFEST.MF文件（含Main-Class定义）
2.2.2 瘦身JAR打包技巧
当依赖过多导致JAR包过大时（我曾遇到300MB+的案例），可采用分层打包：
xml复制<configuration>
<layers>
<enabled>true</enabled>
</layers>
</configuration>
这会生成包含以下层的JAR：
- application：业务代码
- dependencies：第三方库
- snapshot-dependencies：SNAPSHOT依赖
- resources：静态资源
配合Docker镜像构建时，这种分层能显著提升构建效率，因为未变更的层可以直接复用缓存。
2.3 WAR包打包特殊配置
2.3.1 基础WAR配置
需要修改三处关键配置：
xml复制<packaging>war</packaging>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope> <!-- 关键！ -->
</dependency>
</dependencies>
<plugin>
<artifactId>maven-war-plugin</artifactId>
<version>3.3.2</version>
</plugin>
2.3.2 初始化类配置
必须继承SpringBootServletInitializer：
java复制@SpringBootApplication
public class MyApp extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
return builder.sources(MyApp.class);
}
}
血泪教训：我曾遇到部署到WebLogic时因缺少这个配置导致应用无法启动。不同应用服务器可能有特殊要求，比如TongWeb（东方通）需要额外配置weblogic.xml。
3. 高级打包场景实战
3.1 多环境差异化打包
通过Maven Profiles实现：
xml复制<profiles>
<profile>
<id>dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<env>dev</env>
</properties>
</profile>
<profile>
<id>prod</id>
<properties>
<env>prod</env>
</properties>
</profile>
</profiles>
<build>
<resources>
<resource>
<directory>src/main/resources/${env}</directory>
</resource>
</resources>
</build>
执行命令：
bash复制mvn package -Pprod
3.2 依赖冲突解决策略
常见问题场景：
- 不同依赖引入相同JAR的不同版本
- Spring Boot starter与手动添加的依赖冲突
排查工具：
bash复制mvn dependency:tree -Dverbose -Dincludes=:冲突的groupId
解决方案示例（排除特定传递依赖）：
xml复制<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
3.3 资源过滤与加密
3.3.1 敏感信息加密
使用jasypt等工具：
java复制@Bean
public String encryptedProperty(@Value("${encrypted.property}") String property) {
StandardPBEStringEncryptor encryptor = new StandardPBEStringEncryptor();
encryptor.setPassword(System.getenv("ENCRYPTION_PASSWORD"));
return encryptor.decrypt(property);
}
3.3.2 静态资源处理
避免打包后资源路径问题：
java复制@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/static/**")
.addResourceLocations("classpath:/static/");
}
4. 打包后的验证与调试
4.1 JAR包结构检查
解压查看关键目录：
bash复制unzip -l target/your-app.jar
重点关注：
- BOOT-INF/classes下的配置文件是否正确
- BOOT-INF/lib是否包含所有必要依赖
- META-INF/MANIFEST.MF中的Main-Class
4.2 启动参数调优
典型生产环境配置：
bash复制java -Xms512m -Xmx1024m -XX:MaxMetaspaceSize=256m \
-Dspring.profiles.active=prod \
-jar your-app.jar
4.3 常见问题排查指南
4.3.1 ClassNotFoundException
可能原因：
- 依赖未正确打包（检查scope配置）
- 多模块项目中子模块依赖未安装
解决方案：
bash复制mvn clean install && mvn package
4.3.2 启动后立即退出
检查点：
- 确认有spring-boot-starter-web依赖
- 检查主类是否有@SpringBootApplication
- 查看日志中是否有Bean创建失败
4.3.3 静态资源404
验证步骤：
- 检查资源是否在src/main/resources/static下
- 确认没有自定义的WebMvcConfigurer干扰
- 打包后确认资源存在于BOOT-INF/classes/static
5. 生产环境部署实践
5.1 Docker化部署方案
推荐Dockerfile：
dockerfile复制FROM eclipse-temurin:17-jre-jammy
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]
构建命令：
bash复制docker build -t your-app .
docker run -p 8080:8080 -e SPRING_PROFILES_ACTIVE=prod your-app
5.2 传统服务器部署
5.2.1 Systemd服务配置
创建/etc/systemd/system/your-app.service：
ini复制[Unit]
Description=Your Spring Boot App
After=syslog.target
[Service]
User=appuser
ExecStart=/usr/bin/java -jar /opt/your-app/your-app.jar
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
5.2.2 日志管理配置
application-prod.properties示例：
properties复制logging.file.name=/var/log/your-app/application.log
logging.file.max-size=50MB
logging.file.max-history=30
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n
5.3 持续集成实践
Jenkins pipeline示例：
groovy复制pipeline {
agent any
tools {
jdk 'jdk17'
maven 'maven-3.8.6'
}
stages {
stage('Build') {
steps {
sh 'mvn clean package -DskipTests'
}
}
stage('Test') {
steps {
sh 'mvn test'
}
}
stage('Deploy') {
steps {
sshPublisher(
publishers: [
sshPublisherDesc(
configName: 'production-server',
transfers: [
sshTransfer(
sourceFiles: 'target/your-app.jar',
removePrefix: 'target',
remoteDirectory: '/opt/your-app',
execCommand: 'sudo systemctl restart your-app'
)
]
)
]
)
}
}
}
}
在多年的Spring Boot项目部署实践中，我发现最容易被忽视的是打包后的资源路径问题和依赖冲突问题。建议每次打包后都解压检查文件结构，并使用mvn dependency:tree定期检查依赖关系。对于需要部署到国产中间件（如东方通TongWeb）的项目，务必提前测试WAR包兼容性，这些环境往往对Servlet API的实现有特殊要求。