Java 项目打包与部署完全指南：JAR vs WAR，从构建到运行

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 示例

// 打包为 JARapply plugin:'java'// 打包为 WARapply 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-jarapp.jar

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

5.2 后台运行（Linux/Unix）

nohupjava-jarapp.jar>app.log2>&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-jarapp.jar

5.3.2 命令行参数（–）

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

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

5.3.3 外部配置文件

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

5.4 常见 JVM 调优参数

java-Xms512m-Xmx2g-XX:+UseG1GC-jarapp.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 systemctlenablemyapp systemctl start myapp systemctl status myapp

6. 部署 WAR 包

6.1 部署到 Tomcat

步骤 1：安装 Tomcat

# 下载并解压wgethttps://dlcdn.apache.org/tomcat/tomcat-9/v9.0.89/bin/apache-tomcat-9.0.89.tar.gztar-xzfapache-tomcat-9.0.89.tar.gzcdapache-tomcat-9.0.89

步骤 2：放置 WAR 包

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

cpmyapp.war /path/to/tomcat/webapps/

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

步骤 3：启动 Tomcat

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

步骤 4：查看日志

tail-flogs/catalina.out

步骤 5：停止 Tomcat

./bin/shutdown.sh

6.2 部署优化

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

  exportJAVA_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|grep8080# 修改运行端口java-jarapp.jar--server.port=8081

9.4 内存溢出（OOM）

增加堆内存限制：

java-Xms1g-Xmx2g-jarapp.jar

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

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

10. 总结与最佳实践

部署检查清单：

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

下期预告：Docker 化部署 Spring Boot 应用：从 Dockerfile 到 Kubernetes