简介Apache Tomcat 8.5.38 Windows x64 版是一款面向 Java Web 开发者、J2EE 初学者以及需要本地调试 Servlet/JSP 应用人员的轻量级 Web 容器可用于搭建开发测试环境、部署 war 应用并理解 Tomcat 的目录组织与运行机制。压缩包共 645 个文件约 11.08MB涵盖 html 文档、class 字节码、java 源码、jsp 页面、jar 依赖库、xml 配置、bat/sh 脚本及图片字体等类型覆盖 bin、conf、lib、webapps 等典型目录解压后即可按标准结构启动也便于核对发行包的文件完整性与各模块用途。已有 140 人学习下载适合希望动手验证 Servlet/JSP 容器行为、排查部署问题的读者参考。内容涉及 server.xml、web.xml、tomcat-users.xml 等核心配置也包含 Manager 与 Host Manager 管理入口读者可据此熟悉应用部署、用户权限设置、日志查看、连接器调整及基础性能调优思路对目录结构、配置项与实际运行的对应关系形成更直观的认识并为课程设计、小型项目上线前测试提供可直接使用的容器基础。1. 从一次双击闪退说起手上一个跑了些年的 J2EE 老项目要换机器war 包往 apache-tomcat-8.5.38-windows-x64.zip 解出来的目录里一丢双击 startup.bat黑窗口刷两行就没了换个端口重启浏览器又甩回来一个 400 Bad Request。这套 Windows 64 位的 tomcat 8.5.38 免安装包看着是解压即用真正卡人的从来不是解压本身而是 JDK 版本、CATALINA_HOME 指向和 server.xml 里那几行没人愿意细看的默认值。它适合还在维护 javax.servlet 3.1 那套 J2EE Web 项目、需要在 Windows 机器上快速起一个容器的场景要是新项目直接上 Jakarta 命名空间这个版本就别考虑了。下面按我实际装机的顺序走一遍。2. 装前环境盘点JDK 版本和落地目录先定死装 Tomcat 翻车十次里有六次不是 Tomcat 的问题是 JDK 选错或者路径里带了个空格。这一章不动手只做三件事把 JDK 版本定下来、把目录规划好、把机器状态确认一遍。做完再解压后面能省掉一半回头路。2.1 8.5.38 到底该配哪个 JDKTomcat 8.5 这一支官方要求是 Java 7 及以上8.5.38 是这个分支里偏后期的一个小版本规范上实现的是 Servlet 3.1、JSP 2.3、EL 3.0、WebSocket 1.1也就是 J2EE 7 那一套。版本能跑和跑得舒服是两回事我给个我自己的取舍表JDK 版本能不能跑我的实际取舍JDK 7能官方最低要求不推荐TLS 和加密套件都偏老连内网走 HTTPS 都别扭JDK 8能最匹配首选8.5.38 时代的默认搭档JSP 编译、连接池、日志都最省心JDK 11能启动能部署可以跑但反射类库和部分 JSP 标签库会冒模块访问告警要逐个加 --add-opensJDK 17 及以上不建议Jasper 编译和老 jar 的反射容易出问题救起来性价比极低选 JDK 8 还有个现实原因很多老项目的 pom 里写死了javax.servlet-api:3.1.0JDK 8 加 Tomcat 8.5.38 是这套组合里最没有惊喜的搭配。JDK 9 之后模块化带来的访问限制对老依赖是纯粹的负担加参数能压住但没必要给自己找事。先把 JDK 装到不含空格和中文的路径比如C:\env\jdk1.8.0_202然后临时在命令行里验证一遍别急着写进系统环境变量:: 只在当前 cmd 窗口生效用来确认版本和路径对不对 set JAVA_HOMEC:\env\jdk1.8.0_202 set CATALINA_HOMEC:\env\apache-tomcat-8.5.38 set PATH%JAVA_HOME%\bin;%PATH% java -version echo %JAVA_HOME%java -version要能看到 1.8.0_xxx 这一行并且输出来自你刚设的目录而不是机器上原来那个 JDK。这一步的意义在于隔离很多机器上装了不止一个 JDKPATH里排在前面的那个往往是别的工具带进来的Tomcat 启动时用的是JAVA_HOME但你在命令行敲java用的是PATH两者不一致时排查会非常痛苦。我一般让两者指向同一个目录之后所有验证命令才有意义。提示Tomcat 的启动脚本优先认JAVA_HOME没有才去找JRE_HOME。只装了 JRE 的机器必须设JRE_HOME两个都不设startup.bat 会直接退出而且窗口一闪而过不给你看原因。2.2 目录规划空格、中文、括号都是雷C:\Program Files\下面放 Tomcat 是最常见的坏习惯。启动脚本本身能扛住带空格的路径但service.bat注册 Windows 服务时对路径的引号处理历史上一直有缝路径里再带个中文或者括号失败概率直线上升而且报错信息经常只有一句没头没尾的提示。我的固定做法是统一放在一个扁平目录下JDK 和 Tomcat 平级C:\env\ ├── jdk1.8.0_202\ └── apache-tomcat-8.5.38\ ├── bin\ ├── conf\ ├── lib\ ├── logs\ ├── temp\ ├── webapps\ └── work\这样规划还有一个好处将来要在同一台机器上跑第二个实例直接把目录复制一份改端口就行不用去动任何全局配置。Tomcat 支持CATALINA_BASE概念一个CATALINA_HOME可以对应多个CATALINA_BASE每个 base 有自己的 conf、logs、webapps、work。字段说明如下CATALINA_HOME程序本体所在目录放 bin 和 lib一般不变。CATALINA_BASE运行实例目录放 conf、logs、webapps、work有几个实例就有几个。单实例部署时两个可以指向同一个目录一旦要拆只改CATALINA_BASE就行。如果不设CATALINA_BASETomcat 启动时会默认用CATALINA_HOME作为 base这是大多数人的默认状态。理解了这个分层后面「改了配置为什么不生效」这类问题就有了排查方向。2.3 装前清单三条命令确认这台机器能不能开工解压之前先跑三条命令能挡掉一半的返工。:: 1. 确认 JDK 版本和来源 java -version :: 2. 确认 JAVA_HOME 有没有被别的东西污染 echo %JAVA_HOME% :: 3. 确认 8080 和 8005 没被占用 netstat -ano | findstr :8080 :8005对照表如下检查项期望结果不符合怎么办JDK 版本1.8.0_xxx装 JDK 8路径避开空格JAVA_HOME指向刚装的 JDK不带引号和分号清掉旧值重设改完必须重开 cmd8080 / 8005没有输出或者输出的是你要停的进程换端口或按 PID 停掉占用进程netstat -ano输出了行就带上最后的 PID 去tasklist | findstr PID看是谁。这里有个血泪经验环境变量改完不重开命令行窗口读到的永远是旧值echo %JAVA_HOME%看着对实际 Tomcat 拿到的可能还是系统里那份旧的。改完全局变量关掉所有 cmd 窗口重新开一个这是铁律。3. 解压落地从 zip 到能开机自启的服务免安装包的好处是没有注册表污染坏处是所有「安装」动作都得你自己补上目录校验、启动参数、服务注册。这一章把这三件事做完。3.1 解压后先核对目录结构用系统自带解压不一定会出问题但遇到压缩包损坏时的提示很含糊我一般用 7-Zip 之类的工具解压到C:\env\然后把解压出来的目录重命名成apache-tomcat-8.5.38去掉版本后面可能带的额外后缀保证路径干净。解压完别急着启动先确认核心文件在不在路径作用缺失表现bin\startup.bat/catalina.bat启动脚本双击无反应文件根本不存在bin\service.bat注册 Windows 服务想做成服务时抓瞎conf\server.xml端口、Host、Context 都在这里启动报错或用了默认端口lib\catalina.jar容器主体启动立刻抛 ClassNotFoundExceptionwebapps\ROOT默认首页访问 8080 是 404webapps下面默认还有docs、examples、host-manager、manager几个目录。examples在生产环境应该删掉但在装完验证阶段它是很好用的试金石先留着等第 6 章验证完再决定去留。3.2 第一次启动用 catalina.bat run不要用 startup.batstartup.bat 是后台式启动起一个子窗口就退出报错信息在你的眼前一闪而过就没了。第一次启动我强烈建议用前台方式:: 进到 bin 目录-d 保证盘符也切过去 cd /d C:\env\apache-tomcat-8.5.38\bin :: run 表示前台运行报错直接打在窗口里 catalina.bat runrun和start的区别就在这start会新开一个窗口跑父窗口立刻返回你看到的是父窗口的退出码run当前窗口直接阻塞任何异常堆栈都留在屏幕上。启动成功的标志是倒数几行出现Server startup in xxxx ms这个数字是毫秒没有这个数字就是没起来。启动过程会输出大量 JULI 日志其中有一条带org.apache.catalina.core.AprLifecycleListener的 INFO提示 APR 本地库没找到这条是正常现象Windows 免安装包默认不带 tcnative不影响 HTTP 服务不用管它。日志文件在logs\下按日期滚动catalina.YYYY-MM-DD.log是主日志localhost.YYYY-MM-DD.log是应用级日志。Windows 下没有 Linux 里那个catalina.out别去找。3.3 用 setenv.bat 摆 JVM 参数别改 catalina.bat要加内存、改编码、设时区正确位置是bin\setenv.bat。这个文件默认不存在需要你自己建Tomcat 启动时会自动去读它读完再拼参数。:: 文件位置C:\env\apache-tomcat-8.5.38\bin\setenv.bat :: 显式指定 JDK避免机器上多版本打架 set JAVA_HOMEC:\env\jdk1.8.0_202 :: CATALINA_OPTS 只在启动时生效shutdown 时不带 set CATALINA_OPTS-Xms512m -Xmx1024m -Dfile.encodingUTF-8 -Duser.timezoneGMT08 :: 需要额外开放模块时才用JDK 8 上通常不需要 rem set JAVA_OPTS%JAVA_OPTS% --add-opens java.base/java.langALL-UNNAMED参数逐个说清楚-Xms512m初始堆设小了启动后要频繁扩容设大了占机器内存。512m 起步对小项目够用。-Xmx1024m最大堆Xms和Xmx设成一样能避免运行期扩容抖动但 Windows 上会立刻占用物理内存按机器实际情况调。-Dfile.encodingUTF-8影响 JVM 默认字符集读配置文件、写日志都吃这个参数。-Duser.timezoneGMT08容器里的时间跟本地对齐避免日志时间戳错 8 小时。CATALINA_OPTS和JAVA_OPTS的差别后者在停止实例时也会被带上如果你在里面写了堆参数执行 shutdown 时会真的去申请一大块内存机器紧张时可能卡住。启动参数放CATALINA_OPTS是更稳的选择。setenv.bat里必须用set VARvalue这种带引号的写法等号两边别加空格否则变量值会带上一串尾随空格表现为路径明明对却找不到文件。3.4 注册成 Windows 服务以及怎么卸干净要开机自启就得做成服务脚本是bin\service.bat前提是CATALINA_HOME已经设好并且路径不含空格。cd /d C:\env\apache-tomcat-8.5.38\bin :: 安装服务第一个参数是服务名建议带版本号便于机器上并存多个实例 service.bat install Tomcat8538 :: 卸载先停服务再 remove net stop Tomcat8538 service.bat remove Tomcat8538service.bat install不带参数时默认服务名是Tomcat8机器上装过别的 Tomcat 就会撞名装之前先sc query Tomcat8看一眼。安装完服务默认是手动启动需要开机自启就去服务管理器里改成自动。服务方式运行和命令行方式运行有一个关键差异服务启动时工作目录和环境变量来自系统服务和注册表不再继承你当前 cmd 窗口的临时变量。所以你在窗口里set CATALINA_HOME...然后装服务命令行的临时设置其实已经进去了但之后改setenv.bat才是长期有效的做法。卸载时如果服务还在运行remove会失败并提示服务正在使用必须先把服务停掉。卸载完别以为就干净了work和temp下还留着编译产物和临时文件换版本重装前把它们清空能避免很多「明明换了包行为没变」的诡异现象。4. server.xml 配置端口、Host、部署方式三处必改项conf\server.xml是整套配置的核心装完不改早晚出问题。这一章改三处连接器、Host以及部署方式。4.1 Connector端口和编码默认的 Connector 长这样注释掉的是 AJPConnector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /我一般改成Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 URIEncodingUTF-8 maxThreads300 acceptCount100 /port监听端口。8080 被占就换 8081、9090改完两处都要动这里和下一节说的redirectPort。顺便提一句8005是 Server 的 shutdown 端口8009是 AJPWindows 上如果没跑 Apache 前端AJP 那个 Connector 直接整段注释掉少一个暴露面。protocolHTTP/1.1在 Tomcat 8.5 里这个写法会自动选 NIO 实现不是老版本的 BIO。看到有人用org.apache.coyote.http11.Http11NioProtocol全类名效果一样写得啰嗦而已。connectionTimeout连接超时毫秒数20000 是默认长连接场景可以调大。URIEncodingUTF-8Tomcat 8 起默认就是 UTF-8这里显式写出来是为了防另一种情况——从 Tomcat 7 迁移过来的老server.xml里往往写着URIEncodingISO-8859-1它会把默认值覆盖掉然后 GET 请求里的中文参数全变问号。看到中文乱码先查这一行别急着怪前端。maxThreads/acceptCount最大工作线程和等待队列。默认 200 和 100内网小应用不用动并发上来了先看线程池打满时的日志再调这两个值别一上来就调到 2000。4.2 Host用 IP 访问报 400 的真正原因默认 Host 是Host namelocalhost appBasewebapps unpackWARstrue autoDeploytrue它的意思是只接受 Host 头为localhost的请求。你在服务器本机浏览器敲localhost:8080一切正常同事在隔壁机器敲192.168.x.x:8080就返回 400 Bad Request 或者一个空白错误页很多人第一反应是防火墙其实防火墙压根没参与是 Host 匹配不上。改法有两种我倾向加 Alias不破坏默认行为Host namelocalhost appBasewebapps unpackWARstrue autoDeploytrue Alias192.168.1.20/Alias Aliasapp.internal/Alias /Hostname主主机名保持localhost。Alias额外接受的域名或 IP可以写多个内网用 IP 的直接加 IP配了 hosts 或内网 DNS 的加域名。appBase应用根目录相对路径是相对于CATALINA_BASE。unpackWARswar 是否解压运行。设false时直接从 war 里读启动快但静态资源读取效率低一些我一般保持true。autoDeploy是否自动部署新丢进来的 war。开发机开着方便生产环境我通常关掉改由 manager 或重启控制发布节奏。如果直接把name改成 IP本机用localhost访问就会反过来匹配不上。所以加 Alias 更安全。4.3 manager 与用户conf/tomcat-users.xml/manager/html是部署 war、看会话、点重启的图形面板默认打不开因为没配用户。文件是conf\tomcat-users.xml默认内容几乎全是注释。tomcat-users xmlnshttp://tomcat.apache.org/xml version1.0 encodingUTF-8 role rolenamemanager-gui/ role rolenamemanager-script/ user usernameops password换成一串长口令 rolesmanager-gui,manager-script/ /tomcat-usersmanager-gui浏览器访问/manager/html需要的角色。manager-script给 curl、Ant、CI 脚本调/manager/text/deploy用的角色两个分开授权是刻意的设计。password别用默认示例里的短口令这个面板权限等于应用部署权。改完必须重启才生效。另一个高频坑是远程访问/manager/html返回 403webapps\manager\META-INF\context.xml里有一条RemoteAddrValve默认只放行127.0.0.1和::1。内网要放开就得在这条 Valve 里加网段收窄到具体机器比整段放开安全得多。4.4 部署 war 的两种方式和 context 路径规则第一种是丢包把xxx.war放进webappsautoDeploytrue时几十秒内自动展开访问路径就是 war 文件名去掉.war。demo.war对应/demoROOT.war对应根路径/。这里有个细节war 名带版本号如demo-1.0.war路径就是/demo-1.0不会自动截断。第二种是指定外部目录war 不放进webapps适合多实例共享同一份代码Host namelocalhost appBasewebapps unpackWARstrue autoDeploytrue Context path/demo docBaseD:/apps/demo reloadablefalse / /Hostpath访问前缀写/demo就是/demo/xxx。docBase实际目录或 war 文件绝对路径用正斜杠别用反斜杠。reloadable改 class 是否自动重载。开发机设true省事生产环境必须false它会持续扫描类文件变更白烧 CPU。改了 Context 之后如果访问还是老行为去work\Catalina\localhost\下把对应的编译产物删掉再重启。JSP 编译后的 class 缓存在那儿有时候配置已经生效跑的还是老代码。5. 排查避坑五个最常翻车的地方这一章是我这几台机器上反复遇到的按「现象 → 原因 → 解决」记遇到对应症状直接查。现象一双击 startup.bat黑窗口闪一下就没了。原因是启动脚本在进入 Java 之前就退出了最常见的三种JAVA_HOME没设、JAVA_HOME路径带了引号或尾随分号、JAVA_HOME指向的目录里没有bin\java.exe。窗口闪退看不到报错是这件事最烦的地方。 解决在 cmd 里cd /d到 bin 目录执行catalina.bat run把报错捞出来同时用echo %JAVA_HOME%确认值注意输出里不能有引号。如果显示的是C:\env\jdk1.8.0_202或结尾多一个分号重新设一遍改完重开窗口。现象二本机能访问 localhost:8080同事的机器访问不了或者返回 400。原因分两层400 是第 4 章说的 Host 匹配问题完全连不上则是 Windows 防火墙没放行入站端口。 解决先在本机用curl -I http://localhost:8080确认服务活着再用netstat -ano | findstr :8080看监听地址是0.0.0.0:8080还是127.0.0.1:8080。如果只绑了回环地址检查 Connector 上有没有写address127.0.0.1。都正常再去防火墙加 8080 入站规则规则只对需要的网段开放。现象三改了 server.xml 的端口重启后访问还是老端口。原因通常有三个改的文件不是正在跑的那个实例的 conf多实例下 CATALINA_BASE 指向别处改完只是关掉了窗口Java 进程还在新端口被旧进程占着启动失败或者服务方式运行你重启的是命令行实例服务那个根本没动。 解决:: 先看所有 java 进程和它们的 PID jps -l :: 找到跑着 catalina 的那个确认它到底用的哪个目录 wmic process where namejava.exe get ProcessId,CommandLine看到命令行里的-Dcatalina.base指向哪个目录就知道该改哪个文件。改完用netstat -ano | findstr :新端口确认真的起来了。现象四控制台日志和日志文件里的中文全是乱码。原因是编码链路上有几处不一致中文 Windows 的 cmd 默认是 GBK 代码页而 Tomcat 8.5 的conf\logging.properties里java.util.logging.ConsoleHandler.encoding默认是 UTF-8两边对不上。 解决二选一。要么把 cmd 切到 UTF-8chcp 65001再启动缺点是这个窗口里其他中文输出可能变怪要么把logging.properties里那个 encoding 改成 GBK。文件日志本身是 UTF-8 就没问题用支持切编码的编辑器打开即可。两处别同时改改一处看一处。现象五war 丢进 webapps 了manager 里也能看到访问就是 404 或者 503。原因一般是 context 路径不对、应用启动失败但容器没挂、或者 war 本身有依赖缺失。404 是路径没匹配上503 是应用在但没起来。 解决先看logs\localhost.YYYY-MM-DD.log应用启动异常会记在这里找SEVERE关键字。路径不对就检查 war 名有没有带版本号后缀依赖缺失就看WEB-INF\lib下有没有对应的 jar老项目常见的是 Servlet API 被一起打进 war 里跟容器自带的冲突排查时先把它排除掉。注意这五条里凡是「改了没生效」的九成先去确认进程到底读的哪个目录、哪个文件别一上来就怀疑配置写错。进程和配置文件对不上是所有玄学问题的源头。6. 装完怎么验证跑通三组自检和日志读法装完能启动不等于装完能用。我固定走三组自检从容器到 JSP 到面板一层层往上验。第一组容器本身活着。命令和通过标准如下验证项命令通过标准端口监听netstat -ano | findstr :8080出现0.0.0.0:8080的 LISTENINGHTTP 响应curl -I http://localhost:8080返回HTTP/1.1 200Server 头带 Apache-Coyote首页渲染浏览器打开http://localhost:8080出现 Tomcat 的默认欢迎页第二组JSP 和 Servlet 编译链路通。这一步最容易暴露 JDK 版本问题因为 JSP 要经过 Jasper 编译成 class。别自己新建应用直接访问自带的 examples:: examples 里的 servlet 示例能出结果说明 servlet 容器正常 curl http://localhost:8080/examples/servlets/servlet/HelloWorldExample :: 随便挑一个 JSP 示例能出页面说明 Jasper 编译正常 curl -I http://localhost:8080/examples/jsp/第一个命令返回一段 HTML 说明 Servlet 链路通第二个返回 200 说明 JSP 编译没被 JDK 版本卡住。如果这里报Unable to compile class for JSP基本就是 JDK 版本过高或者JAVA_HOME指错了回第 2 章重来。第三组管理面板和部署链路。浏览器开http://localhost:8080/manager/html用第 4 章配的用户登录能进去看到已部署应用列表就说明角色配对了。这一步验证的是部署通道以后线上发版要么走这个面板要么用manager-script角色配合脚本通道通了才谈得上后续。最后说一下日志怎么读。启动完成后logs\catalina.YYYY-MM-DD.log里最后几行大概是这样信息: Starting ProtocolHandler [http-nio-8080] 信息: Server startup in 3287 msServer startup in这一行的毫秒数很有参考价值。冷启动三秒左右很正常突然变成三十秒通常是有应用在初始化时卡在外部连接上比如数据库连接池首次建连超时顺着这行往上看能定位到具体哪个应用拖慢了整体启动。排查线上问题也是同一个入口findstr /C:SEVERE过滤一遍比从头翻日志快得多。从那以后我每装一台 Tomcat哪怕是解压即用的 zip 包也强制走一遍「java -versionecho %JAVA_HOME%netstat 看端口」这三条再点启动。后来还发现一个小技巧验证完把webapps\examples、docs和host-manager删掉只留ROOT和manager端口暴露面小一圈也让下次启动快一点。这套流程走顺了8.5.38 这个免安装包其实非常省心——难的是装之前那几步没做而不是包装得不好。希望帮到你。本文还有配套的精品资源点击获取
