Java项目打包与部署的完全指南(JAR vs WAR)

1. 引言

项目开发完成后，如何将其部署到服务器上，让用户能够访问？对于 Java 开发者而言，打包和部署是上线前最后、也是最关键的一步。Java 项目通常打包成两种格式：JAR 和 WAR。选择哪种包，以及如何部署，取决于项目类型、运行环境和团队习惯。

本文将从零开始，带你全面了解：

• ✅ JAR 包与 WAR 包的本质区别和适用场景
• ✅ 使用 Maven/Gradle 打包的具体命令
• ✅ 部署 JAR 包的多种方式（前台、后台、参数配置）
• ✅ 部署 WAR 包到 Tomcat 的详细步骤
• ✅ 部署流程全景图与常见问题排查

无论你是刚入门的开发者，还是需要负责上线任务的工程师，都能从中获得实用的指导。

2. JAR vs WAR：核心区别

3. 打包前的准备：项目类型判断

在打包之前，先明确你的项目是什么类型：

• 如果是 Spring Boot 项目（默认打包为 JAR，但也可配置为 WAR）
• 如果是 传统 Servlet/JSP 项目（通常打包为 WAR）
• 如果是 纯工具类/批处理应用（一定是 JAR）

可以通过 pom.xml（Maven）或 build.gradle（Gradle）中的打包配置判断。

Maven 示例

<!-- 打包为 JAR -->
<packaging>jar</packaging>
<!-- 打包为 WAR -->
<packaging>war</packaging>

Gradle 示例

// 打包为 JAR
apply plugin: 'java'
// 打包为 WAR
apply plugin: 'war'

4. 打包命令详解

4.1 Maven 项目

常用组合：

# 跳过测试，快速打包
mvn clean package -DskipTests
# 生成可执行 JAR（需 Spring Boot Maven 插件）
mvn clean package spring-boot:repackage

4.2 Gradle 项目

打包后的文件位置：

• Maven：target/xxx.jar 或 target/xxx.war
• Gradle：build/libs/xxx.jar 或 build/libs/xxx.war

5. 部署 JAR 包

5.1 基本运行命令

java -jar app.jar

该命令会在前台运行，按 Ctrl + C 会终止进程，关闭终端也会导致进程退出。

5.2 后台运行（Linux/Unix）

nohup java -jar app.jar > app.log 2>&1 &

• nohup：忽略挂断信号，关闭终端后进程继续运行
• > app.log：标准输出重定向到文件
• 2>&1：将错误输出也重定向到同一个文件
• &：后台运行

查看进程：ps -ef | grep app.jar
停止进程：kill -9 <PID>

5.3 指定参数

5.3.1 系统属性（-D）

java -Dserver.port=8081 -Dspring.profiles.active=prod -jar app.jar

5.3.2 命令行参数（–）

Spring Boot 支持使用 -- 直接覆盖配置：

java -jar app.jar --server.port=8081 --spring.datasource.url=jdbc:mysql://localhost:3306/mydb

5.3.3 外部配置文件

java -jar app.jar --spring.config.location=/path/to/application.yml

5.4 常见 JVM 调优参数

java -Xms512m -Xmx2g -XX:+UseG1GC -jar app.jar

• -Xms：初始堆内存
• -Xmx：最大堆内存
• -XX:+UseG1GC：使用 G1 垃圾回收器

5.5 使用 systemd 管理 JAR（生产推荐）

创建服务文件 /etc/systemd/system/myapp.service：

[Unit]
Description=My Spring Boot Application
After=network.target
[Service]
User=appuser
ExecStart=/usr/bin/java -jar /opt/myapp/app.jar
SuccessExitStatus=143
Restart=always
[Install]
WantedBy=multi-user.target

启用并启动：

systemctl daemon-reload
systemctl enable myapp
systemctl start myapp
systemctl status myapp

6. 部署 WAR 包

6.1 部署到 Tomcat

步骤 1：安装 Tomcat

# 下载并解压
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.89/bin/apache-tomcat-9.0.89.tar.gz
tar -xzf apache-tomcat-9.0.89.tar.gz
cd apache-tomcat-9.0.89

步骤 2：放置 WAR 包

将生成的 .war 文件复制到 Tomcat 的 webapps 目录下：

cp myapp.war /path/to/tomcat/webapps/

Tomcat 会自动解压并部署（默认会监听 8080 端口）。访问地址：http://localhost:8080/myapp/

步骤 3：启动 Tomcat

./bin/startup.sh   # Linux
# 或
./bin/startup.bat  # Windows

步骤 4：查看日志

tail -f logs/catalina.out

步骤 5：停止 Tomcat

./bin/shutdown.sh

6.2 部署优化

• 配置虚拟路径：修改 conf/server.xml，添加 <Context> 元素。
• 热部署：将 WAR 放到 webapps 后，Tomcat 会自动重新部署（但生产环境不建议）。
• 内存配置：修改 bin/catalina.sh（或 setenv.sh）：

export JAVA_OPTS="-Xms512m -Xmx2g"

6.3 其他容器

• Jetty：将 WAR 放到 webapps 目录，运行 java -jar start.jar
• WebLogic / WebSphere：通过管理控制台部署

7. 部署流程全景图

8. 常用命令速查表

9. 常见问题与解决方案

9.1 JAR 包运行提示 “no main manifest attribute”

原因：打包时没有指定主类（Main-Class）。
解决（Spring Boot）：确保 spring-boot-maven-plugin 已配置。

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
</plugin>

9.2 WAR 包部署后访问 404

• 检查 webapps 下是否生成了同名目录。
• 确认访问路径：http://ip:port/项目名/。
• 查看 logs/catalina.out 是否有部署错误。

9.3 端口冲突

# 查看端口占用
netstat -anp | grep 8080
# 修改运行端口
java -jar app.jar --server.port=8081

9.4 内存溢出（OOM）

增加堆内存限制：

java -Xms1g -Xmx2g -jar app.jar

9.5 后台运行的 JAR 如何查看实时日志？

tail -f app.log   # 如果重定向到了文件
# 或使用 journalctl（systemd 管理时）
journalctl -u myapp -f

10. 总结与最佳实践

部署检查清单：

• ✅ 打包前运行所有测试
• ✅ 使用 -DskipTests 加速构建（仅当测试已覆盖）
• ✅ 配置 JVM 堆大小和垃圾回收器
• ✅ 将配置文件外置，避免重新打包
• ✅ 配置日志轮转（如 logrotate）
• ✅ 设置健康检查端点，配合监控系统

以上就是Java项目打包与部署的完全指南(JAR vs WAR)的详细内容，更多关于Java项目打包与部署的资料请关注脚本之家其它相关文章！