服务器上的war包怎么替换,替换后如何重启Tomcat服务?

替换服务器上的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

赞 (0)
上一篇 2026年11月21日 11:05
下一篇 2026年11月21日 11:06

相关推荐

  • AI电子班牌打折是真的吗?电子班牌多少钱一台

    2026年AI电子班牌打折促销已进入深度博弈期,建议直接锁定“双11”或“开学季”前的厂家直营渠道,通过批量采购协议争取到低于市场均价30%以上的终端成交价,同时务必确认是否包含三年免费运维服务,2026年AI电子班牌价格跳水背后的行业逻辑硬件成本下降与供应链成熟近年来,随着触控屏模组、主控芯片以及物联网通信模……

    程序编程 2026年6月6日
    4900
  • 三洋服务器报警AL53怎么维修,故障代码含义是什么?

    三洋服务器报警AL53的维修关键在定位电源域故障,先看管理卡日志再换电源模块,多数情况能直接解决,报警代码AL53出现在三洋服务器管理接口中,通常被解释为电源模块状态异常,但实际维修时不能只盯着电源插头,要从日志、指示灯、物理线路三个方向交叉确认,避免误判,三洋服务器报警AL53怎么维修:五步排查法接到“三洋服……

    2026年10月16日
    800
  • 广州网络主机怎么选?云计算服务器哪家好

    2026年广州企业部署网络主机,首选具备本地BGP网络与等保合规资质的云服务器,以低延迟、高弹性的架构实现业务降本增效,广州网络主机核心架构与选型标准为什么广州节点是华南业务首选广州作为国家级互联网骨干直联点,其网络主机具备天然的辐射优势,根据中国信通院2026年《云计算白皮书》数据,华南地区超68%的泛娱乐与……

    2026年4月28日
    6700
  • 构建数字出版数据仓库有哪些步骤?数字出版数据仓库怎么建

    生产、分发与变现的全链路数据孤岛,通过建立统一的数据标准与实时处理架构,实现从粗放式管理向精细化运营的转型,数字出版行业正处于从“流量红利”向“数据红利”转型的关键期,过去,出版社和平台各自为战,数据分散在ERP、CMS、APP后台等多个系统中,导致决策滞后、用户画像模糊,构建一个高效的数据仓库不再是技术炫技……

    2026年5月26日
    4200
  • tenda为什么会显示远端服务器无响应,路由器断网如何解决

    当Tenda路由器提示“远端服务器无响应”时,核心原因是路由器WAN口无法成功连接互联网,通常表现为PPPoE拨号失败、DNS解析异常或运营商网络中断,下面直接拆解问题根源,并给出从简单到复杂的修复路径,先搞懂“远端服务器无响应”到底在说什么这个提示其实是在告诉你:你的Tenda路由器没有从运营商那里拿到有效的……

    2026年10月17日
    900
  • 我的世界服务器作弊附魔mod怎么用,附魔指令是什么?

    想给自己的服务器装作弊附魔mod,核心思路是先装好前置mod(大多数需要Forge或Fabric),再把作弊附魔mod文件放进mods文件夹,重启服务器后用游戏内指令或配置文件来获取和调整附魔,整个流程并不复杂,但不少玩家卡在版本不匹配或者权限设置上,下面我把从零开始的完整操作步骤拆开讲清楚,先搞清楚服务器端和……

    2026年10月16日
    800
  • Ajax安全性问题js怎么解决?前端如何防止XSS攻击

    AJAX安全性问题的核心在于异步请求缺乏同源策略的天然屏障,必须通过严格的输入验证、CSRF令牌机制及HTTPS加密来构建防御体系,在Web开发的演进历程中,AJAX(Asynchronous JavaScript and XML)彻底改变了用户与服务器交互的方式,让页面无需刷新即可更新内容,这种便捷性也引入了……

    2026年6月2日
    3000
  • Microsoft Excel真的免费吗?Excel2026永久免费激活教程

    Microsoft Excel并没有永久免费的官方版本,但微软提供了功能完整的Excel Online网页版供个人非商业用途免费使用,同时Windows 10/11系统自带的WPS Office或LibreOffice可作为本地免费替代方案,若需完整桌面版功能则需订阅Microsoft 365,很多人一提到Ex……

    2026年7月11日
    13600
  • AIoT挖掘机是什么?智能挖掘机怎么选购

    AIoT挖掘机通过物联网与人工智能技术的深度融合,实现了从“被动执行”到“主动感知、智能决策”的跨越,显著提升了施工效率并降低了运维成本,是工程机械行业数字化转型的核心载体,想象一下,一台挖掘机不再仅仅是一堆冰冷的钢铁,而是一个拥有“眼睛”和“大脑”的聪明伙伴,它不仅能看清脚下的每一寸土地,还能根据土壤硬度自动……

    2026年6月13日
    3600
  • 戴尔r430服务器怎么做RAID5,具体步骤是什么

    首段需用加粗直接给出核心答案,戴尔r430服务器怎么做RAID 5,核心路径是开机自检时按Ctrl+R进入PERC BIOS配置界面,创建虚拟磁盘并选择RAID 5级别, 整个流程不需要操作系统参与,半小时以内即可完成配置,关键在于前期确认磁盘数量和阵列卡型号是否支持,戴尔r430怎么做RAID5:完整操作路径……

    2026年8月27日
    1300

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注