将Jar包部署到服务器本质上就是上传文件、配置运行环境、启动进程并确保它能持续稳定运行,整个过程在Linux服务器上通常不超过十分钟。
很多开发者第一次接触服务器部署时,总以为是什么高深莫测的操作,其实把Jar包部署到服务器上,跟你在自己电脑上双击运行一个Java程序没有本质区别,只是换了个“房间”而已,这篇文章会从零开始,把每一步的关键动作和坑都给你说透。
部署前的准备工作:服务器和本地环境的检查
在动手之前,得先确认三件事,否则后面会白忙活。
服务器上必须装好Java运行环境
Jar包是Java程序的打包产物,服务器上必须有对应的Java环境才能跑起来,这里有个容易犯的错:本地用的是Java 11,服务器上装的是Java 8,直接运行就会报UnsupportedClassVersionError。
- 检查服务器Java版本,执行命令
java -version - 如果没有安装,可以用
yum install java-11-openjdk(CentOS)或apt install openjdk-11-jdk(Ubuntu) - 如果服务器上有多个Java版本,用
update-alternatives --config java切换默认版本
确认服务器类型和登录方式
绝大多数情况下,你的服务器是Linux系统(CentOS、Ubuntu、Debian都常见)。你需要通过SSH工具连接服务器,Windows用户可以用Xshell、FinalShell,Mac用户直接用终端就行。
把Jar包传到服务器上的方法
上传文件主要有三种方式,看你的使用习惯:
- rz命令:在SSH终端输入
rz,会弹出文件选择窗口(需先安装lrzsz) - SFTP工具:FileZilla、WinSCP这类可视化工具,直接拖拽上传
- scp命令:在本地终端执行
scp xxx.jar root@服务器IP:/usr/local/app/
行业共识是,正式生产环境推荐用scp或CI/CD流水线自动部署,rz命令更适合临时测试。
Linux服务器部署Jar包的三种主流方式
这一部分是核心,我按推荐程度从低到高给你拆解。
直接使用nohup命令后台运行
这是最朴素也最常用的方式,适合快速上线和临时测试。
nohup java -jar app.jar > app.log 2>&1 &
这条命令的意思是:让Jar包在后台运行,不随SSH窗口关闭而结束,同时把日志输出到app.log文件里。
启动后可以用 ps -ef | grep java 来确认进程是否存在,如果要停掉服务,先找到进程号(PID),kill -9 进程号。
这种方式虽然简单,但有个明显的短板:如果服务器重启,服务不会自动启动,你得手动再敲一遍命令,如果Jar包意外崩溃,没有守护机制帮你把它拉起来。
使用systemd注册为系统服务
这是我自己最推荐的方式,也是目前生产环境的主流做法。把Jar包交给systemd托管,可以实现开机自启、崩溃自动重启、日志统一管理,一劳永逸。
在 /etc/systemd/system/ 目录下新建一个service文件,app.service:
[Unit]
Description=Jar包部署在服务器上的示例服务
After=network.target
[Service]
ExecStart=/usr/bin/java -jar /usr/local/app/app.jar
Restart=always
RestartSec=5
User=root
[Install]
WantedBy=multi-user.target
然后执行以下命令让配置生效并启动服务:
systemctl daemon-reload systemctl start app systemctl enable app
之后你就不再需要手动管理进程了。查看日志用 journalctl -u app -f,停止服务用 systemctl stop app,服务器重启后,服务会自动跟着启动。
使用Docker容器化部署
如果你的服务器上装了Docker,或者公司规范要求容器化部署,那就用Docker方式,它的好处是环境隔离、版本管理方便、迁移简单,尤其适合微服务架构。
先写一个Dockerfile:
FROM openjdk:11-jre-slim COPY app.jar /app.jar EXPOSE 8080 ENTRYPOINT ["java", "-jar", "/app.jar"]
构建镜像并启动容器:
docker build -t my-app . docker run -d --name app-container -p 8080:8080 my-app
容器方式的缺点是对新手来说理解成本稍高,要熟悉Docker的基本概念和命令。
三种部署方式的对比与选择建议
| 对比维度 | nohup方式 | systemd方式 | Docker方式 |
|---|---|---|---|
| 上手难度 | 最容易 | 中等 | 较高 |
| 开机自启 | 不支持 | 支持 | 支持(需设置) |
| 崩溃重启 | 不支持 | 支持 | 支持(需设置) |
| 日志管理 | 手动重定向 | journalctl统一管理 | docker logs |
| 适合场景 | 临时测试 | 单机生产环境 | 集群/微服务 |
我给新手朋友的建议是:优先用systemd方式,它比nohup更规范,比Docker更直观,而且Linux服务器部署jar包用这种方式也是最常见的招聘要求。
部署完成后必须做的验证和排查
服务启动不代表部署成功,得确认它能正常对外提供服务。
检查端口和进程状态
netstat -tlnp | grep 8080 ss -tlnp | grep 8080 curl http://localhost:8080/health
如果curl能返回预期结果,说明服务已经正常启动,如果提示连接失败,多数情况下是Jar包没起来或端口被占用。
排查日志是解决疑难杂症的王道
不管部署jar包时遇到什么问题,第一反应应该是看日志,nohup方式的日志在指定的log文件里,systemd方式用 journalctl -u app -f 实时查看。
常见报错就那几类:
- 端口被占用:
Address already in use,用lsof -i:8080找到占用进程并处理 - 内存不足:
OutOfMemoryError,需要调大JVM参数java -Xms512m -Xmx1024m -jar app.jar - 数据库连接不上:检查application.yml里的数据库地址、账号密码是否正确,以及数据库本身是否放开了防火墙策略
常见问题与避坑指南
为什么本地运行正常,部署到服务器就报错?
这是最典型的一个问题。绝大多数情况是环境不一致导致的:Java版本不同、操作系统不同、依赖的外部服务地址不对,比如本地连的是localhost的数据库,服务器上自然找不到。
解决方案是:检查服务器上的Java版本是否匹配,检查配置文件里的地址是否为服务器可访问的地址,注意Linux对文件大小写敏感,配置文件里写的路径要跟你实际放置的一致。
防火墙和安全组没有放行端口
服务器部署完后外部访问不到,先别急着怀疑代码,检查云服务器的安全组规则和Linux防火墙。
firewall-cmd --add-port=8080/tcp --permanent firewall-cmd --reload
如果用的是简米云、酷番云这类云服务器,还需要在控制台的安全组里添加入方向规则,放行8080端口。
Jar包部署到服务器上,哪家的服务器更合适?
不少朋友在部署前会纠结服务器选型。多数情况下,国内部署就选简米云、酷番云,海外业务选AWS或华为云,从价格角度看,新用户购买轻量应用服务器通常有较大折扣,一年几百元就能满足日常测试和小型业务需求,如果你只是学习Java部署,本地虚拟机或者免费的云开发者平台也够用了。
业务量上来了,怎么更新Jar包而不中断服务?
简单粗暴的方式是:先停掉服务,替换Jar包,再启动服务,但中间会有几十秒的空白期。要求高的话需要配置负载均衡,用滚动发布的方式逐一更新后端节点,对于单机部署,可以写一个简单的脚本,把备份旧包、上传新包、重启服务的动作串起来,减少人工操作失误。
部署完之后的进程守护和性能优化
设置JVM参数,避免内存溢出的风险
服务器不是只有你这一个Jar包在跑,不给JVM设置内存上限,它默认会用掉服务器物理内存的1/4,很浪费资源,启动时显式指定:
java -Xms256m -Xmx512m -jar app.jar
-Xms是初始内存,-Xmx是最大内存,根据服务器实际配置合理设置,如果机器内存是2G,给Jar包分配512M比较合理。
用脚本简化你的日常运维操作
与其每次手动敲启动命令,不如写一个shell脚本维护,网上的脚本模板有很多,核心逻辑就是:先找到旧进程PID杀掉,然后重新启动Jar包并记录新PID,脚本内容很简单,十几行就能搞定。
常见问题问答
jar包部署在服务器上后,怎么配置环境变量?
在启动命令前加环境变量即可:export JAVA_HOME=/usr/local/java && export PATH=$JAVA_HOME/bin:$PATH,也可以在systemd的service文件里用 Environment= 行指定环境变量,如果Jar包里有读环境变量的代码,务必保证这些在启动前已正确设置。
本地运行正常但部署到Linux服务器后中文变成乱码?
服务器系统默认字符集通常不是UTF-8,导致打印日志时中文乱码,检查Linux的locale设置,执行 locale 看输出结果,建议在启动参数里加上 -Dfile.encoding=utf-8,同时确保application.yml里配置了UTF-8编码,这样日志和接口返回值都能正常显示中文。
部署jar包时提示“no main manifest attribute”怎么处理?
这个报错说明Jar包里没有指定启动类,多数情况下是你本地打包时maven的spring-boot-maven-plugin没有正确配置,导致打出来的是普通Jar包,不是可执行Jar包,检查pom.xml里的plugin配置,重新执行 mvn clean package 后再上传,也可以直接使用IDEA的package命令重新打包。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/805690.html


