第 11 章:Maven 打包 + Linux 部署(SpringBoot jar 包部署)
前置:多环境配置已经完成,pom 打包插件已经修复无重复
目标:把项目打成可执行 jar 包,上传到 Linux 服务器,后台常驻运行、查看日志、停止服务
一、打包操作(两种方式,任选其一)
方式一:IDEA 图形界面操作(推荐新手)
- IDEA 右侧边栏打开 Maven 面板
- 展开你的项目
szyt→ 找到Lifecycle - 双击 clean
- 控制台跑日志,看到
BUILD SUCCESS代表清理成功;这一步会删掉旧的 target 文件夹
- 控制台跑日志,看到
- 等 clean 跑完,再双击 package
- 开始编译代码、打包,等待控制台输出
BUILD SUCCESS
- 开始编译代码、打包,等待控制台输出
- 打包产物位置:项目根目录下自动生成
target文件夹- 里面:
szyt-0.0.1-SNAPSHOT.jar就是可执行 jar 包 - 可以复制这个文件,重命名为
szyt.jar方便后面命令使用
- 里面:
❗注意:打包过程如果报红、BUILD FAILURE,就是打包失败,把控制台报错发给我排查。
方式二:终端命令打包(和上面图形界面等价)
-
IDEA 底部打开 Terminal 终端(或者 cmd)
-
确认当前路径是项目根目录(能看到 pom.xml)
-
输入命令回车执行:
mvn clean package -DskipTests
clean:清理旧文件package:打包-DskipTests:跳过单元测试,不跑测试代码,打包更快
- 同样打包成功后,jar 包在
target/下面
找到打包产物,打包成功后本地测试(必做)
打包成功后,在项目目录:target/szyt-0.0.1-SNAPSHOT.jar
这个就是我们的可执行 jar 包,你可以复制一份重命名为 szyt.jar,后续命令书写更简单。
-
终端 cd 进入 target 目录
cd target
-
执行启动命令,指定 dev 环境
java -jar szyt-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev
-
看日志:出现
The following profiles are active: dev,端口 8080,用 Postman 访问之前写的 CRUD 接口,能正常返回,说明 jar 包没问题。
启动成功,控制台输出 The following profiles are active: dev,Postman 访问接口正常,说明 jar 包没问题。
⚠️ 本地测试需要本机有 JDK17,并且 MySQL 服务正常启动。


二、Linux 服务器部署(重点)
前提:Linux 服务器已经安装 JDK17、MySQL;服务器开放端口(8080/8081/8082)安全组放行
工具:Xshell(连接服务器)、Xftp(上传 jar 包)
1. 上传 jar 包
在 Linux 新建目录存放项目,比如:
mkdir -p /home/szyt
把 szyt.jar 上传到 /home/szyt
2. 前台启动(仅用来测试,关闭窗口程序就停)
cd /home/szyt
java -jar szyt.jar --spring.profiles.active=prod
看到日志正常输出、环境激活 prod,代表启动成功;按 Ctrl+C 停止。
3. 后台常驻启动(生产正式使用,nohup)
nohup java -jar szyt.jar --spring.profiles.active=prod > szyt.log 2>&1 &
解释:
nohup:脱离终端后台运行,关闭 ssh 窗口不停止程序> szyt.log 2>&1:把所有输出日志写入 szyt.log 文件&:放到后台执行
4. 常用运维命令(必背)
# 查看进程,找到szyt的java进程pid
ps -ef | grep szyt
# 停止服务(把下面数字替换成查到的pid)
kill -9 进程号
# 实时查看日志
tail -f szyt.log
# 清空日志文件
> szyt.log
⚠️ Linux 部署高频坑
- 服务器防火墙 / 云厂商安全组没放行端口 → 外部访问不通
- 服务器 MySQL 远程访问没开(root 账号不允许localhost以外连接)
- 服务器 JDK 版本不是 17,启动直接报错
- prod.yml 里面数据库地址、账号密码写错
三、测试验收
- 上传 jar 包到 linux
- 使用 nohup 后台启动,指定 prod 环境
- 用 Postman 访问
http://服务器IP:8082/你的接口地址,能正常返回数据即部署成功