把项目部署到Tomcat服务器上,核心就一句话:把你的Web应用打包成WAR包放到Tomcat的webapps目录下,启动Tomcat即可自动完成部署。无论是个人练手项目还是小型生产环境,这套流程都适用,下面按部署前的准备、WAR包部署、IDE集成部署、常见问题排查四个模块拆开讲,全程给可操作的命令和路径。
部署前需要准备好哪些东西
动手之前先检查环境,很多部署失败都卡在这个环节。
JDK版本必须和Tomcat大版本匹配。 Tomcat 9对应JDK 8及以上,Tomcat 10对应JDK 11及以上,Tomcat 11则要求JDK 17以上,版本不匹配时,启动日志会报UnsupportedClassVersionError,你根本看不到Tomcat的欢迎页。
Tomcat本身要下载对了。 去Apache官网下载Core二进制版,Windows选.zip,Linux选.tar.gz,千万别下载Windows Service Installer版本,那个只适合部署在Windows服务器上,开发机调试用zip版就够了。
JAVA_HOME环境变量必须配置。 Tomcat的startup.bat(或startup.sh)靠这个变量找Java运行时,Windows上在系统属性里建JAVA_HOME指向JDK安装目录,Linux下改/etc/profile或~/.bashrc,配置完打开命令行输入java -version确认能正常输出版本号。
准备一个能跑的Web项目。 不要求多复杂,哪怕是Spring Boot打包的纯接口项目,或者一个最简单的JSP页面,只要编译通过、本地能跑起来就行,项目部署到tomcat服务器上的前提是项目本身不出错,否则排查起来会分不清是环境问题还是代码问题。
WAR包部署方式详解
这是生产环境最常用、最规范的部署方式,步骤清晰,也方便回滚。
第一步:把项目打成WAR包
如果你用Maven,在项目根目录执行:
mvn clean package
构建完成后,WAR包在target/目录下,如果配置了finalName,文件名就是你指定的名字;没配的话就是项目名.war。
如果你用IDEA,接好Maven后侧栏点Lifecycle里的package,效果同上,Gradle项目用gradle bootWar或者gradle war对应的任务就行。
如果你用的是传统方式,没有构建工具,直接手动把整个WebContent目录里的内容按WAR标准结构整理一遍,然后用压缩工具打包成zip,改后缀为.war,不过这种情况建议尽快换成Maven,手搓WAR包容易漏文件,部署后各种ClassNotFound很折磨人。
第二步:停掉正在运行的Tomcat
看情况,如果Tomcat已经从服务方式启动(比如注册成Windows服务或systemd服务),需要先把服务停掉,再动webapps目录,直接命令行杀Tomcat进程会导致文件被占用,Windows下报的文件lock错误就是这么来的。
第三步:把WAR包复制到webapps目录
这是整个部署流程里最关键的一步,直接把你的.war文件扔进{Tomcat安装目录}/webapps/下。
启动Tomcat后,它会自动解压WAR包,生成同名的文件夹,访问路径是http://localhost:8080/你的WAR包名字/资源路径。
如果你想让项目直接通过根路径访问(比如访问http://localhost:8080/直接打开项目首页),有几种做法:
- 把WAR包命名为
ROOT.war - 把解压后的文件夹删掉,手动把项目内容整理进
ROOT目录 - 配置server.xml的Host标签里的Context,设置path=””
多数情况下直接用ROOT.war最简单,但要注意ROOT目录下原来默认的index.jsp会干扰访问,删掉即可。
第四步:启动Tomcat
Windows在bin目录下双击startup.bat,Linux执行./bin/startup.sh,让输出日志直接在终端滚动,方便实时看错误。
想后台运行用nohup ./bin/startup.sh &,日志写入logs/catalina.out,排查问题就看这个文件。
启动之后,浏览器访问http://localhost:8080/你的WAR包名/,能打开页面说明第一步成功,如果打不开,去看控制台报错,先确认8080端口没有被占用。
开发模式下用IDEA直接部署
平时写代码测试,每次都手动打WAR包再复制,效率太低了,IDEA内置的Tomcat集成可以直接把项目部署上去,支持热部署。
在IDEA里打开项目,按下面步骤操作:
- Run菜单 → Edit Configurations → 左上角加号 → 找到Tomcat Server,点Local
- 在Application server那里点Configure,指向你的Tomcat目录
- 切换到Deployment选项卡,点加号选Artifact,选
你的项目:war exploded,Application context填写路径名,比如/demo - 回到Server选项卡,确认On ‘Update’ action和On frame deactivation都选了
Update classes and resources - Apply后直接Run
这种方式改完JSP或Java文件,IDEA会自动把改动推到Tomcat的部署目录里,浏览器刷新就能看到效果,不用重启,日常开发效率比打WAR包高得多。
注意development和测试环境下用这种方式没问题,但正式生产环境不建议用IDEA的Artifact部署,不利于脚本化运维和容器化。
Tomcat部署项目的各种方式对比:
| 部署方式 | 适用场景 | 操作成本 | 是否支持热部署 | 生产环境推荐度 |
|---|---|---|---|---|
| WAR包放入webapps | 生产环境、发布新版本 | 低,复制粘贴即可 | 不支持 | 高 |
| IDEA集成部署 | 日常开发、本地调试 | 低,点一次启动 | 支持 | 低 |
| server.xml配置Context | 需要自定义路径映射 | 中,配置较繁琐 | 支持 | 中 |
| 直接解压文件夹放webapps | 快速验证 | 低 | 不支持 | 低 |
外部访问的前提是防火墙放行了8080端口,简米云或酷番云的服务器,别光在本地测通了就以为大功告成,去安全组规则里看下入方向有没有放行8080,这是新手部署到云服务器上最常见的坑。
Linux环境下部署war包会用到的操作
很多生产服务器是Linux系统,这里补一下Linux上部署tomcat项目的完整流程,虽然原理和Windows完全一样,但实际操作路径上有几个细节不同。
先把Tomcat的tar.gz包传到服务器上,一般放到/usr/local/或者/opt/目录,解压:
tar -zxvf apache-tomcat-9.0.x.tar.gz
mv apache-tomcat-9.0.x /usr/local/tomcat
cd /usr/local/tomcat
然后把你本地打好的WAR包上传上去,用scp命令:
scp ./target/你的项目.war root@你的服务器IP:/usr/local/tomcat/webapps/
上传完成直接启动:
/usr/local/tomcat/bin/startup.sh
检查是否启动成功有几种方式:
ps -ef | grep tomcat查看进程是否存在tail -f /usr/local/tomcat/logs/catalina.out看日志输出curl http://localhost:8080/你的项目名/验证本地响应
如果配置了MySQL等外部依赖,注意检查服务器防火墙或者数据库的IP白名单,否则项目启动时连不上数据库会抛异常。
关闭Tomcat用/usr/local/tomcat/bin/shutdown.sh,如果遇到进程关不掉的情况,用kill -9 进程号强制结束,然后重新启动。
部署失败怎么排查
部署后访问报错,大部分问题出在这几个地方。
404错误,项目页面找不到
先确认你访问的路径和WAR包名字是否一致。http://localhost:8080/user/userList,说明WAR包应该叫user.war,且项目内部有userList的访问路径,大小写也要注意,Linux下路径严格区分大小写。
然后检查webapps目录下有没有解压出来的同名文件夹,如果没有,说明WAR包没被自动解压,要么是文件损坏,要么是启动过程中报错了,去看catalina.out。
端口被占用
Tomcat启动时抛出Port 8080 required by Tomcat v9.0 Server at localhost is already in use,说明8080端口被其他程序占了,Windows下用netstat -ano | findstr 8080找到PID,杀掉对应进程;Linux下用lsof -i:8080来看端口占用情况。
这里顺便提一句修改端口的方法:去conf/server.xml,把Connector标签里的port改成其他值,比如8081。
内存溢出(OutOfMemoryError)
部署了多个项目,或者项目本身比较吃内存,会报java.lang.OutOfMemoryError: Java heap space,修改bin/catalina.bat(Windows)或bin/catalina.sh(Linux)的开头部分,设置JAVA_OPTS参数:
JAVA_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m"
Xms表示初始内存,Xmx表示最大内存,根据机器配置调整,云服务器内存只有2G的话,别贪心设太大,给系统留够余量。
JDK版本问题
控制台报Exception in thread "main" java.lang.UnsupportedClassVersionError,说明JDK版本太旧,或者Tomcat版本太新,去安装对应版本的JDK即可。
Tomcat虚拟主机多项目部署
一台服务器部署多个项目各自的域名,需要配置虚拟主机,打开conf/server.xml,在Host标签下添加Context:
<Context path="/projectA" docBase="/data/apps/projectA" reloadable="true"/>
“`
这里docBase指向项目实际所在路径,不一定非要在webapps下面,可以放在服务器任何有权限的目录,reloadable=”true”表示类文件变化时自动重启当前应用,生产环境根据需要设为false,能省点资源。
行业共识认为,虚拟主机方式管理多个项目时,隔离性不如容器方案,但胜在轻量快速、不引入额外运维复杂度,很多老项目至今仍用这种方式跑着。
部署后验证清单
最后过一遍确认清单,确保部署确实成功而不是看着像成功。
- 访问首页能正常返回HTML,状态码200
- 页面引用的CSS/JS/图片能正常加载
- 登录、查询等涉及数据库的操作没报错
- 后台日志没有异常堆栈
- 重启一次Tomcat后项目还能自动恢复
一项一项过完,就没问题了,整个流程核心步骤就是:打包 → 放进webapps → 启动 → 验证,熟练之后耗时不到两分钟,前面踩过版本匹配的坑,后面基本畅通无阻。
常见问题解答
部署到tomcat服务器后,怎样让项目通过IP直接访问不需要带项目名称?
把WAR包改名为ROOT.war放进webapps目录,访问http://你的IP:8080/就会直接打开项目首页,原有的ROOT目录里如果有内容就清空或删除,因为ROOT.war解压时会覆盖同名目录。
tomcat部署项目有几种方式,哪种适合初学者?
最常见的有三种方式:WAR包直接放进webapps目录,IDEA里配置Tomcat Server启动项目,还有在server.xml里手动配置Context路径,如果你是刚接触部署的新手,推荐先从WAR包方式入手,流程最短、出错点最少,当你需要频繁修改代码调试时,再转向IDEA集成方式。
生产环境部署项目时war包和文件夹部署有什么区别?
功能上二者完全等价,Tomcat对待两者的方式一致,区别在于文件管理方式:WAR包文件单一,易于拷贝和备份,配合Jenkins做持续交付时也不用解压,直接替换包文件再重启就行,文件夹方式在更改单个文件时直接操作文件系统,不用重新解压整个包,但你得注意保持目录结构的完整性,多数情况下推荐用WAR包,构建产物即交付物,更符合工程化要求。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/802428.html


