简介Tomcat 9.0.96 的 Windows 64 位安装包提供了完整的 Java Web 运行环境面向需要在本地开发、测试或部署 Servlet/JSP 应用的开发者与运维人员。压缩包内共 653 个文件以网页文档、JSP 页面、编译类文件、依赖包、配置文件和启动脚本为主目录结构清晰整体大小约 13.91MB解压后稍作设置即可使用。内附的 server.xml、context.xml、web.xml 等配置文件可分别调节端口、全局上下文和 Web 应用部署参数配合启停管理脚本即可完成日常操作。作为 9.0 系列较新版本Tomcat 9.0.96 支持更新的 Java 标准并修复了以往披露的多个安全漏洞。目前已有 433 人学习下载适用于本地开发测试、中小型 Web 应用部署也可与 Apache HTTP Server 配合实现动态与静态内容分离。 很多人在Windows上装Tomcat第一反应是找一个带界面的exe安装包一路Next完事。实际上以我这些年配过不下几十个Tomcat环境的经验来看最省心的反而是那种看着不起眼的绿色zip包比如apache-tomcat-9.0.96-windows-x64.zip。它不注册系统服务、不写注册表、不污染启动项解压就一个目录想换版本直接换目录部署到别的机器还能整包拷走几乎零成本迁移。真正让人头疼的从来不是下载而是解压之后那一串环境变量、启动日志和端口冲突。这篇就从下载开始把安装、配置、部署、排错的全链路讲透小白照着做能跑起来老手也能在踩坑部分找到点有用的东西。1. 下载前先分清三件事zip包、安装版和JDK版本1.1 为什么绿色zip包是绝大多数场景的最优解Apache官网Tomcat 9下载页面会同时提供zip和Windows Service Installer两种Windows安装形式再往上有tar.gz和源码包。很多人习惯性去点那个exe安装版其实在非生产环境和个人开发机上zip完胜。安装版会额外做三件事往系统服务里注册Tomcat进程、在安装路径上创建卸载程序、把配置写进Windows的注册表和服务的相关配置中。这意味着你改个端口、切个JDK都得去服务管理器里重启Tomcat出了问题卸载还不一定卸得干净有时候能留下一堆残留服务。而zip包是纯绿色结构所有东西都限定在一个目录里启动用startup.bat停止用shutdown.bat删了目录就相当于卸载没有任何残留。有一点需要特别注意Tomcat虽然是Apache基金会的项目但它不是Apache HTTP Server两者没有任何依赖关系。不用先装Apache再来跑TomcatTomcat本身就是独立的Java Web服务器。1.2 系统位数和JDK版本这个坑十个人里有三个人踩标题里的x64对应的就是64位Windows系统。现在的Windows 10/11几乎全是x64Tomcat 9官方也确实以x64包为主只要你不是还在用十几年前的32位系统下这个包就没问题。如果处理器是ARM架构那才需要考虑别的选择普通x64机器直接忽略。JDK版本是比系统位数更关键的变量。Tomcat 9.0.x的硬性要求是Java 8及以上JDK 8、JDK 11、JDK 17都能跑。我实测JDK 17跑Tomcat 9.0.96启动速度和内存占用都很正常没有遇到兼容性问题。但新手最容易忽略的是Java包名差异。Tomcat 9对应的是Servlet 4.0规范代码里引用的是javax.servlet.*这样一组旧的命名空间。非要解释的话Java之前把Web相关API归在javax.servlet后来整套体系改名成jakarta.servletTomcat 10开始才切换过去。如果你的项目代码是javax.servlet.http.HttpServlet这种写法用Tomcat 9是完全正确的如果项目里写的是jakarta.servlet那别犹豫你该用Tomcat 10或11。这块搞反了项目在IDE里编译能过一部署就各种ClassNotFound或者404排查半天也找不出原因。确认JDK是否装好最直接的办法是打开命令提示符运行java -version能看到版本号就说明JDK已安装。如果提示找不到命令大概率是没装或者环境变量没配置。这一步建议放在下载Tomcat之前做避免解压完才发现缺环境白忙一场。JDK的下载渠道很多微软和Oracle都有官方构建版本也包括开源的Adoptium发行版任选一个稳定版本即可安装路径记好后面配JAVA_HOME要用。2. 解压不是双击完事目录结构就是Tomcat的说明书2.1 每个目录是干什么的拿到zip包之后用压缩软件解压到磁盘。这里有个我踩过很多次的坑安装路径不要用中文不要带空格也不建议直接放C盘根目录或者桌面。Python和Java类的开发环境对路径里的特殊字符很敏感Tomcat虽然大多数情况下能撑住但某些老项目、旧版插件会在路径解析上出问题那种问题最难查。我个人的习惯目录是D:\dev\apache-tomcat-9.0.96纯英文、短路径、几层目录结构清晰。解压完成后你会看到这么一层结构这就是Tomcat的说明书目录/文件作用重要程度bin存放启动、关闭、服务安装等脚本日常使用最频繁conf核心配置文件server.xml、web.xml等高改端口、调线程都在这里libTomcat运行依赖的jar包一般不用动logs运行日志排错第一现场高temp临时文件目录低webapps应用部署目录war包放这里高workJSP编译后的class文件缓存低可删除重建新手最容易犯的错是去lib目录里塞自己项目的jar包这是当年Tomcat 6之前的旧做法现在完全没有必要还容易引发类冲突。你的项目依赖应在项目内部管理不要污染Tomcat的lib。2.2 bin目录下那几个bat文件到底谁是谁bin目录里的文件很多新手只需要认得四个startup.bat、shutdown.bat、catalina.bat、service.bat。startup.bat启动Tomcat双击运行。shutdown.bat停止Tomcat。catalina.bat核心运行脚本你可以在它后面加参数比如catalina.bat run会以前台方式运行Tomcat并持续打印日志对排查启动问题非常好用catalina.bat version能打印版本和JVM信息。service.bat把Tomcat注册成Windows系统服务服务器部署时才有必要用个人开发机上不建议碰。很多人双击startup.bat时会出现一个黑窗口一闪而过就以为Tomcat启动了。实际上那个黑窗口是控制台只要还开着就代表Tomcat在前台运行关闭窗口等于停止Tomcat。黑窗口消失只有两种可能要么你把它关了要么启动失败异常退出了。这个在后面排查章节会详细说。2.3 webapps和logs是后续最常用的两个目录webapps目录的高频用途有两个把打包好的war文件丢进去实现部署或者把一个前端项目、一个Servlet项目直接以标准目录结构放进去。Tomcat启动时会自动扫描这个目录里的war包和解压目录完成部署。ROOT子目录对应的是访问根路径http://localhost:8080/的那个默认应用也就是你第一次启动后看到的那只猫的页面。logs目录则记录了Tomcat的全部运行痕迹。catalina.日期.log是主日志记录启动过程、异常栈、运行期报错localhost.日期.log记录具体Web应用在启动和部署时抛出的异常应用挂了经常要看这个文件manager相关的日志则是管理后台的访问记录。排错第一步永远是去logs目录翻最新日期的文件而不是在浏览器里反复刷页面。3. 环境变量配置启动闪退十有八九是这一步3.1 JAVA_HOME是第一个必须配的变量Tomcat本身是Java程序启动前必须知道JDK装在哪它主要靠JAVA_HOME环境变量来定位。操作路径不复杂右键“此电脑”→属性→高级系统设置→环境变量在“系统变量”区域点击“新建”变量名填JAVA_HOME变量值填JDK安装的根目录。这里有个极易踩的坑变量值必须填JDK的根目录不能填到bin目录也不能填到jre目录。比如你JDK装在C:\Program Files\Java\jdk-17那变量值就是这个路径不要自作主张在末尾加\bin。Tomcat的setclasspath.bat脚本会自动在JAVA_HOME后面拼接bin\java.exe去找启动程序你多写一层它反而找不到。图形界面操作完记得重新开一个命令提示符窗口因为新设置的环境变量不会自动注入已打开的窗口。验证方法是echo %JAVA_HOME%能打印出路径就代表设置生效接着跑一下%JAVA_HOME%\bin\java -version确认路径无误。3.2 CATALINA_HOME和PATH的作用以及不配的后果CATALINA_HOME是Tomcat自己使用的辅助变量指定Tomcat的解压根目录比如D:\dev\apache-tomcat-9.0.96。这个变量的主要用途是给IDE、自动化脚本以及Tomcat内部某些脚本定位资源用的不配的话你自己手动运行startup.bat也能启动但IDEA里的Tomcat集成、进一步的Service安装、某些部署插件可能找不到Tomcat根目录。PATH里要不要加Tomcat的bin目录取决于使用习惯。加了之后可以在命令行任意路径下直接敲startup.bat启动不加也不影响使用。我个人的习惯是不往PATH里加因为在本地开发时Tomcat更多是交给IDEA管理而不是手动命令行操作PATH越干净未来出现诡异的全局命令冲突的概率越低。3.3 路径里的空格和中文Windows特有的坑JDK默认安装路径在C:\Program Files\Java\jdk-17Program Files里带着空格。在设置环境变量时直接在图形界面的变量值里填写带空格的路径是没问题的因为系统环境变量管理器会自动处理引用。但Tomcat某些内部脚本在执行时可能因为引号拼写问题而找不到JAVA_HOME这种问题在部分JDK版本和Tomcat版本组合下偶有出现。如果你在配置之后启动依然报“找不到JAVA_HOME”可以试一试把JDK安装到不带空格的路径下比如C:\Java\jdk-17然后再把JAVA_HOME指过去这是Windows上规避这类环境问题最简单粗暴的办法。同理Tomcat的解压路径也建议不要带空格这也是我前面推荐D:\dev\apache-tomcat-9.0.96而非D:\Program Files\Tomcat的原因。4. 首次启动与验证学会看日志比反复刷新页面有用4.1 启动的正确姿势配置完环境变量进入bin目录双击startup.bat会弹出一个新的命令行窗口并开始滚动日志。看到类似Server startup in [1500] milliseconds的内容就说明启动成功。此时打开浏览器访问http://localhost:8080能看到Tomcat默认首页的那只猫一切正常。这个黑窗口就是Tomcat的前台控制台它不只是个“启动器”Tomcat的运行日志会实时打印在里面。你在部署war包、访问应用时控制台会同步输出访问和错误信息。对本地开发来说这个窗口不要关关闭等于停止Tomcat。如果觉得这个窗口太碍事或者想让它最小化到后台运行那就考虑用service.bat把Tomcat注册成Windows服务这是后话。一个小技巧如果你用startup.bat启动遇到问题建议改用catalina.bat run来启动。这个命令同样会启动Tomcat且日志直接在当前窗口输出但它不会自动关闭窗口排错时比startup.bat更直观因为你能看到完整报错而不是一闪而过的黑窗。排查完问题再回到startup方式不迟。4.2 启动成功的标志是什么别只看那只猫看到localhost:8080上的猫页面说明默认应用起来了但一个Web应用实例是否完全就绪要以日志为准。打开logs目录下的catalina.当天日期.log找到以下几行关键日志就算真正启动成功org.apache.catalina.startup.Catalina.start Server startup in [1423] milliseconds前面的数字是你这次启动的耗时通常在几百到几千毫秒区间取决于机器性能和项目数量。如果这个日志没出现说明启动过程在中途失败了哪怕浏览器页面能打开也可能是缓存或者之前的进程残留。新手容易被“页面能打开就万事大吉”的假象误导程序挂了一半的情况很常见。4.3 启动后logs目录里该关注谁Tomcat日志文件不止一个。排查启动异常时的顺序建议是先看catalina.日期.log这是全局日志启动框架级错误、端口绑定失败、类加载异常都在这里再看localhost.日期.log你部署的应用如果报错一大堆异常栈通常会在这里重复出现最后看manager.日期.log这个一般只记录管理后台的行为个人开发很少涉及。这三个日志文件是不同维度的catalina关注的是Tomcat服务器自身localhost关注的是部署在上面的Web应用。项目部署失败、404、ClassNotFound这种问题十有八九要去localhost日志里定位。5. 部署第一个Web项目war包与IDE集成5.1 war包部署最简单的上线方式本地开发完一个Java Web项目后打包成war文件直接复制到webapps目录下Tomcat启动时会自动解压并部署。假设你放了一个demo.war启动完成后访问地址通常是http://localhost:8080/demo/URL里的路径和war包文件名一致。想把应用挂到根路径上访问就把war包改名为ROOT.war访问时直接http://localhost:8080就能进应用首页。这个机制本质上是Tomcat的自动部署功能在起作用。它的好处是不用重启Tomcat运行时发现问题把war包删掉或替换Tomcat会自动重新加载对应应用。但在生产环境里我会建议关闭自动部署改为手动控制。这不是说自动部署不好而是生产环境需要对变更时机严格把控避免半成品包被自动加载造成事故。开发机上放心用效率优先。5.2 IDEA旗舰版、社区版和Eclipse的Tomcat配置差异IDEA旗舰版自带Tomcat集成。配置路径是File→Settings→Build, Execution, Deployment→Application Servers点击加号选择Tomcat Server指定Tomcat的安装目录即可。之后在Run/Debug Configurations里创建一个Tomcat Server→Local的配置Run起来IDEA会自动启动Tomcat并部署当前项目。IDEA社区版不带Application Servers但这不代表没法用Tomcat。社区版可以装Smart Tomcat插件配置上比旗舰版略微简化本质上是通过插件帮你调用了Tomcat的启动脚本并在IDE里整合控制台输出。热词里很多人搜“idea社区版配置tomcat”基本都是这种情况。还有一个选择是直接用Maven的cargo插件或tomcat7-maven-plugin来启动不走IDE集成这种方式对社区版同样友好。Eclipse用户则走Windows→Preferences→Server→Runtime EnvironmentsAdd一个Tomcat 9的运行时再在Servers面板里创建Server实例。Eclipse的Servers机制和IDEA的Application Servers作用一样都是让IDE能够控制Tomcat生命周期并自动部署项目。5.3 部署后必踩的坑404、根路径、热部署配置好IDE项目也能正常启动但访问页面时容易遇到404。原因通常有三个项目上下文路径对不上、访问的URL少写了一层、应用没成功解压。打开http://localhost:8080/项目名/具体页面路径时注意项目名和具体页面路径之间不要漏掉斜杠。如果项目名对不上去IDEA的运行配置里看Deployment页签Application context填的是什么访问路径就是什么。另一个坑是热部署不生效。IDEA里修改了Java代码如果你用的不是Debug模式或者没有配置Update resources服务器不会自动重编译和热替换。这个时候最常见的操作是把所有修改保存后点击IDEA的Update按钮触发重新部署或者干脆重启Tomcat比在代码里反复刷新页面靠谱得多。6. 启动失败与运行异常的完整排查链路6.1 闪退先加pause看报错比瞎猜有用双击startup.bat窗口一闪而过Tomcat没起来。这是Tomcat新手遇到最多的情况。产生闪退的直接原因是启动脚本执行过程中发生了错误而此时脚本已经运行到了末尾控制台窗口自动关闭。要让错误信息留在眼前最粗暴有效的办法是编辑startup.bat在最后一行的exit之前加一行pause再双击运行窗口就会停在报错信息画面上。但更推荐的做法是打开命令提示符手动切到bin目录下执行catalina.bat run。这个命令的前台运行方式不会自动关窗所有报错信息都清晰可见。我排查过几十次启动问题catalina.bat run能直接定位到九成以上的根因剩下的才需要去翻日志文件。闪退最常见的原因是JAVA_HOME没有配置或者配置错误。报错信息通常会明确提示“The JAVA_HOME environment variable is not defined correctly”或者“At least one of JAVA_HOME or JRE_HOME must be set”。这时代码都不用看回去检查环境变量就行。其次是CATALINA_HOME配置错误或者路径中有不可见字符检查变量值是否准确指向了Tomcat解压目录。6.2 端口占用8080被占改端口还是杀进程启动时日志里出现一堆Caused by: java.net.BindException: Address already in use说明8080端口被占用了。Windows上排查端口占用有一套标准动作。首先在命令提示符里执行netstat -ano | findstr :8080输出的最后一列是占用8080端口的进程PID。然后根据PID找到对应进程tasklist | findstr PID确认是什么程序占用的。如果是无关程序可以执行taskkill /PID PID /F强制结束或者干脆改Tomcat端口。改端口需要编辑conf/server.xml找到HTTP连接器那一行Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /把port8080改成8081或其他未占用端口。注意8080不是唯一需要检查的端口server.xml里还有两个关键端口Server port8005 shutdownSHUTDOWN用于管理关闭命令AJP连接器默认使用8009。这三个端口任何一个被占用Tomcat都起不来。如果8080被占但你不想改端口也可以检查一下8005和8009有没有冲突。还有一个Windows 10/11上的隐藏杀手Hyper-V保留端口。某些端口段会被Hyper-V、WSL等系统组件动态保留程序绑定失败但netstat查不到明确占用。此时可以执行netsh interface ipv4 show excludedportrange protocoltcp如果8080恰好在保留区间内只能换一个端口没别的办法。6.3 中文乱码Windows控制台与Tomcat日志的编码之争Tomcat启动后控制台和日志里出现一堆中文乱码这个问题出现频率超高。根因是Tomcat 9内部默认使用UTF-8编码而Windows中文版控制台默认使用的是GBK编码两边的字符集对不上。Tomcat在日志里写的欢迎这两个UTF-8字节被控制台用GBK解码就变成乱码了。处理办法有两个层面。一个是在conf/logging.properties里找到java.util.logging.ConsoleHandler.encoding这一行把默认的UTF-8改成GBK控制台输出就会正确显示。这个改动只影响Tomcat打印到控制台的内容不影响你Web应用本身的编码。另一个方案是把WindowsTerminal或命令提示符的代码页切到UTF-8执行chcp 65001后重启Tomcat同样能避免乱码。但乱码问题不仅要看Tomcat日志还要看应用日志和页面显示是否乱码。如果是页面上数据库里读出来的中文乱码那多半是项目JDBC连接串里没加characterEncodingutf-8或者数据库表字符集设置不对这已经超出Tomcat本身的范畴了。IDEA控制台里中文乱码是另一个独立场景需要在IDEA的Help菜单里Edit Custom VM Options加上-Dfile.encodingUTF-8再在运行配置里把VM options也加上同样的参数两处缺一处都不行。6.4 启动后一堆线程名不用慌多数是正常的有朋友问过一个问题Tomcat启动之后用jstack能看到一大堆http-nio-8080-exec-xx、Timer-xx、RMI TCP Connection线程是不是中病毒了这还真不是。http-nio-8080-exec-xx这类线程是Tomcat为处理HTTP请求创建的线程池工作线程启动时就预创建了一批数量取决于server.xml里maxThreads的配置默认值是200所以看到几十个线程很正常。RMI TCP Connection和RMI TCP Accept这类线程一般来自JMX远程管理、Spring框架的内部通信或者一些中间件的心跳检测机制也是正常现象。想让这些线程完全消失可以关闭JMX远程接口或在启动参数里去禁用对应组件但没有任何必要。Tomcat启动后线程多本身就是Java Web应用正常运行的代价之一。还有一类情况是启动日志卡在某个位置看起来像卡死实际上是在等待某个外部资源。比如应用启动过程中需要连接数据库、Redis或注册中心连接不上就会长时间停留。看catalina日志和localhost日志找出最后一条有效信息通常能定位到是哪个外部依赖导致启动挂起。不要再在浏览器里一遍遍刷新页面日志永远是最快的答案。在结尾再分享几个小技巧Tomcat 9.0.96这个版本虽然看起来是9.x的延续但它依然在持续维护安全补丁和修复都在跟进不要因为版本号旧就轻视。升级Tomcat时记得备份conf目录和webapps目录这两个目录是你所有自定义配置和应用的地方其它目录删掉重来都行。另外本地调试时如果觉得启动慢可以把JVM初始堆内存和最大堆内存调高一点在catalina.bat里加一行set JAVA_OPTS-Xms512m -Xmx1024m对老项目的稳定运行很有帮助。装Tomcat这件事本身不复杂复杂的是它背后连着的JDK、端口、编码和日志理清这几条线你在任何一台Windows机器上都能把Tomcat收拾得服服帖帖。本文还有配套的精品资源点击获取