替换服务器上的war包,核心就三步:备份旧包、上传新包、重启服务,整个过程按规范操作,三到五分钟就能完成,不会丢数据也不会影响线上业务。
war包是Java Web项目的标准打包格式,无论是自建机房还是云服务器,替换逻辑都一样,下面按真实运维场景逐层拆解,从准备工作讲到收尾验证。
替换war包前,先把环境信息摸清楚
很多人上来就传包,结果传到一半才发现磁盘满了,或者连不上服务器,动手之前花两分钟确认三件事,能省掉大半的返工时间。
确认服务器类型和Web容器版本
先登录服务器,用命令确认操作系统和Java环境:
cat /etc/redhat-release # 查看Linux发行版版本 java -version # 确认JDK版本
然后确认Web容器,市面服务器上跑的Java中间件,Tomcat占比最高,另外还有Jetty、Undertow、WebLogic、WildFly等,不同容器的部署目录和重启方式不一样,查一下进程就知道:
ps -ef | grep java
进程路径里如果带tomcat字样,看清楚是哪个版本的Tomcat。Tomcat 8.5之后和Tomcat 9、10的目录结构基本一致,但如果你用的是Tomcat 7或更早版本,部分配置项有差异,下文讲到具体地方会标注。
确认war包部署路径和日志位置
每个Web容器都有独立的webapps目录,Tomcat默认的部署路径一般是:
/usr/local/tomcat/webapps/
但很多公司会改路径,你需要用下面的方式定位:
find / -name "webapps" -type d 2>/dev/null
或者直接看Tomcat的配置文件server.xml:
cat /usr/local/tomcat/conf/server.xml | grep docBase
日志位置同样重要,默认在/usr/local/tomcat/logs/下,有catalina.out、localhost.log等文件,后面排查问题时全靠这些日志。
备份旧war包:这一步永远不要跳过
行业共识认为,替换war包前必须先做备份,这个习惯能救你无数次,新包如果有问题,备份就是你的后悔药。
进入webapps目录,把旧包复制一份,命名加上日期:
cd /usr/local/tomcat/webapps/ cp old-project.war old-project-20260115.war
拷贝完成以后,确认一下备份文件大小和原包一致:
ls -lh old-project.war old-project-20260115.war
如果你用的是云服务器,建议再花十秒把备份包下载到本地,服务器磁盘故障或者误删,本地还有一份,至于平台差异问题简米云服务器和酷番云的镜像系统虽然不同,但war包替换的命令和流程在Linux下完全通用,不需要额外适配,你要用的是Windows Server,那对应的就是远程桌面上传和文件管理器操作了。
上传新war包到服务器的几种方式
备份做完,下一步把新包传上去,服务器在本地机房还是云上,决定了你选哪种传输方式。
本地上传到Linux服务器的常用命令
scp命令是运维最常用、最稳定的方式,直接在本地终端执行:
scp ./new-project.war root@你的服务器IP:/usr/local/tomcat/webapps/
如果服务器端口不是默认的22,加上-P参数:
scp -P 2222 ./new-project.war root@服务器IP:/usr/local/tomcat/webapps/
rz命令适合用的Xshell、FinalShell这类终端工具的用户,优点是弹窗选文件,操作直观,适合新手,一次性把war包放到临时目录,再移动到位:
rz mv /tmp/new-project.war /usr/local/tomcat/webapps/
FTP或者SFTP工具也常见,但大多数图形化工具本身也就是封装了scp或SFTP协议,传输原理一样,上传完成后务必核对一下文件大小:
ls -lh /usr/local/tomcat/webapps/new-project.war
看看是否和本地包大小一致,如果相差几个字节,说明传输不完整,直接删了重新传。
重启服务的关键细节:先停后删再启
新war包到位后,重启容器前有个容易踩坑的顺序问题,很多war包替换后出问题都是这一步操作不当。
停掉Tomcat服务
找到Tomcat的bin目录,执行关闭脚本:
/usr/local/tomcat/bin/shutdown.sh
停完之后务必确认进程真的退了:
ps -ef | grep tomcat
如果进程还在,说明有线程卡住,可以等几秒再看一次,实在退不掉才用kill命令:
kill -9 进程PID
kill命令是最后手段,尽量不要直接用,容易导致缓存没来得及写入,引发数据问题。
删除旧的解压目录
war包放到webapps下以后,Tomcat启动时会自动解压成同名的文件夹,如果你直接覆盖war包重启,新包和旧解压文件混在一起,可能导致新代码和旧资源冲突,出现各种奇奇怪怪的报错。
正确的做法是,把webapps下对应的旧项目和旧war包一起清理掉:
cd /usr/local/tomcat/webapps/ rm -rf old-project/ # 删除旧解压目录 rm -f old-project.war # 删除旧war包
然后把新war包移动到这个目录:
mv /tmp/new-project.war /usr/local/tomcat/webapps/
新war包名称要跟旧包保持一致,比如你项目访问路径是http://IP:8080/old-project,那war包名称必须叫old-project.war,千万别改名,改名等于换了个新应用,访问路径全变了。
启动服务并观察日志
执行启动脚本:
/usr/local/tomcat/bin/startup.sh
启动之后立刻盯日志:
tail -f /usr/local/tomcat/logs/catalina.out
看到Deployment of web application archive ... has finished in xxx ms这样的关键行,说明war包部署成功。
验证接口和页面是否正常
通过curl命令在服务器本地验证:
curl -I http://localhost:8080/old-project/
返回HTTP 200说明正常,返回404说明部署路径不对,返回500说明代码有异常,去看catalina.out里的异常堆栈。
还要确认一下新版本功能是否生效,找一个本次版本改动的接口,请求一下看看返回值是否符合预期。
快速回滚方案:新包出问题也不慌
如果不幸新包有问题,回滚动作要快,删除新包和解压目录,把备份包还原:
cd /usr/local/tomcat/webapps/ rm -rf new-project/ new-project.war cp ../backup/new-project.war .
重新启动就回滚完毕,整个回滚过程能在两分钟以内完成。
其他Web容器替换war包的差异点
Tomcat之外,其他容器替换方式大同小异,但有几个关键差异点要留意。
Spring Boot内置Tomcat的情况
Spring Boot项目常用内置Tomcat打成可执行jar/war包,此时不能往外部Tomcat里扔,你应该这样操作:
# 停旧进程,找到对应的Java进程 ps -ef | grep your-app.jar kill -9 进程ID # 备份并替换jar包 mv your-app.jar your-app-20260115.jar.bak mv /tmp/your-app.jar ./ # 重启服务 nohup java -jar your-app.jar > app.log 2>&1 &
Spring Boot的war包替换严格来说已经不是传统Tomcat方式了,但很多人问的“war包怎么部署到服务器”其实就是这类场景,按上面这套流程走准没错。
WebLogic和WildFly的部署方式
WebLogic的war包部署通常通过管理控制台操作,webapps目录不直接生效,替换路径是:登录控制台 → 部署 → 更新 → 选择新war包,然后激活更改。
WildFly则使用standalone.sh脚本和deployments目录,支持自动部署模式把war包拷进去就自动加载,删掉就自动卸载,比Tomcat方便一些,如果用Docker部署war包,把war包通过docker cp命令拷进容器里,或者重新构建镜像,两者都行。
war包替换常见问题排查手册
据近年来的运维反馈,war包替换问题集中在下面几个方向,逐个对照排查。
上传后访问还是旧页面
- 这个问题出现频率最高,大多数情况是浏览器缓存导致。
- 按
Ctrl+F5强制刷新,或者用无痕模式访问试试。 - 如果还是旧页面,检查webapps下解压目录的时间戳是不是刚刚生成的,确认war包有没有被Tomcat重新加载。
上传后404页面
- 检查war包名称和访问路径是否一致。
- 确认new.war是不是有效包,可以用解压工具打开看看内容。
- 看
catalina.out日志里有没有部署失败的信息,例如端口被占用、解压异常。
上传后500错误
- 新版本代码本身有问题,数据库连接配置不对,或者依赖的jar包缺失。
- 直接看日志
catalina.out的最新异常信息,定位到具体哪一行报错。
上传成功后接口正常,但页面样式全丢了
- 静态资源路径不对,项目里写的是绝对路径,新旧版本上下文路径有变化。
- 让前端开发确认静态资源的引用方式和部署路径是否匹配。
war包部署相关的常见疑问解答
war包替换后不重启Tomcat能不能生效?
只要Tomcat开启了自动部署(默认开启),war包放入webapps目录后会自动解压生效,但自动部署不一定完全干净,代码中的静态资源或配置缓存可能不会被正确清理,生产环境建议手动重启,避免新旧代码混跑。
替换war包期间访问的用户会不会受影响?
如果在停Tomcat期间有人发起请求,就会直接看到报错页面,低峰期操作可以最大限度降低影响,比较高可用的做法是部署到集群环境,一台一台轮换更新,或者用Nginx做灰度发布,先把流量切到另一台机器上,如果用的简米云服务器,也可以在控制台直接做SLB灰度,先把A机器摘除流量再更新,完成后拉回,再切B机器重复操作。
war包和文件夹两种部署方式有什么区别?
war包部署便于分发和版本管理,上传后由容器自动解压,文件夹部署直接把编译好的class和页面文件drop到webapps目录,适合开发环境或小改动场景,生产环境以war包部署更规范,可追溯性强。
把备份、上传、清理、重启、验证每一步都落到实处,war包替换就是个重复性的熟练活,服务器上替换war包这件事本身不难,真正拉高门槛的是操作习惯,养成备份优先、日志先行的习惯,线上War包替换出问题的概率会大幅下降,即使出了问题,也能在几分钟内恢复。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/806985.html

