简介Apache Tomcat 8.5.38 Windows 64位版是一款轻量级开源Java应用服务器面向J2EE开发者与运维人员用于部署和运行Servlet、JSP等Java Web应用。它实现了Servlet与JSP容器规范适合中小型项目开发、测试与生产环境也是学习Java Web技术的常用平台。压缩包共645个文件约11.08MB涵盖html、class、java、jsp、jar、xml、bat、sh、properties等类型分别对应文档、编译类、源码、页面、依赖库、配置与启停脚本目录结构完整包含bin、conf、lib、webapps、logs等标准模块。已有140人学习下载。解压后可直接通过startup.bat与shutdown.bat启停服务配合server.xml、web.xml、tomcat-users.xml完成端口、应用与用户配置并支持war包部署、Manager管理、SSL安全加固及IDE集成调试便于快速搭建J2EE运行环境并掌握服务器配置与优化思路。1. 一个老版本 Tomcat 压缩包为什么还有人专门找apache-tomcat-8.5.38-windows-x64.zip这个文件名做 Java Web 的人一眼就能拆出四层信息Apache 基金会下的 Tomcat8.5 大版本38 这个补丁号Windows 64 位免安装压缩包。会专门搜这个全名的人通常不是新手随便下个最新版而是手里有个老系统必须跑在 8.5.x 的某个具体补丁上或者要在一台不能联网的内网 Windows 机器上把服务支起来。它解决的核心问题很朴素给一个 Servlet/JSP 应用提供能跑起来的容器而且是不写注册表、解压即用的那种。适合谁维护遗留系统的后端、做内网交付的实施、以及需要固定中间件版本做兼容性验证的测试。这一章先把「这个包到底是什么、为什么是它」讲清楚后面再动手。Tomcat 8.5 这个分支本身是个过渡产物它实现了 Servlet 3.1、JSP 2.3、EL 3.0同时把 8.0 里那套基于 NIO 的默认连接器继续打磨又提前吸收了一部分 9.0 的改进。8.5.38 属于 8.5 后期的一个补丁版本修了一批连接器、会话管理和安全相关的缺陷。很多人找它是因为生产上跑着的应用在某个 8.5.x 上验证过升级到 9 会碰到包名、API 或配置项的差异回退又不想退太狠于是锁定一个相对靠后的 8.5 补丁。Windows x64 这个后缀则说明它是给 64 位 JVM 用的压缩包里带的是.bat启动脚本而不是.sh目录结构和 Linux 版一致差别只在脚本和默认路径分隔符。需要先明确一点这个 zip 是免安装版不是 Windows 服务安装包。解压出来就能用但不会自动注册成系统服务也不会帮你配开机自启。这既是优点也是坑——优点是不污染系统、可以多份共存、删目录就等于卸载坑是很多人解压完直接双击startup.bat黑窗口一关服务就没了还以为是 Tomcat 崩了。所以这一篇的路线是先把这个包的结构和依赖讲透再给一套能复现的部署步骤然后重点讲参数怎么调、日志怎么看、以及那些年踩过的坑。2. 解压前后要搞清的东西目录结构、JDK 依赖与端口占用拿到apache-tomcat-8.5.38-windows-x64.zip之后别急着双击。先花五分钟把「它依赖什么、解压出什么、默认占什么端口」这三件事确认掉能省掉后面一大半的排查时间。这一章讲的是动手前的地基地基没打牢后面调参数都是白调。2.1 先确认 JDK 版本别让 Tomcat 找不到 javaTomcat 8.5 要求 JDK 7 及以上但实际生产里我一般建议配 JDK 8。原因很直接8.5 的很多默认配置和 JDK 8 的 TLS、加密套件行为匹配得最好用 JDK 11 跑 8.5 虽然能起来但个别老应用的反射和类加载会出玄学问题。Windows 上最容易翻车的是JAVA_HOME没配或者配错导致startup.bat一闪而过。先在命令行确认# 查看当前 java 版本确认是 64 位 java -version # 输出里如果有 64-Bit 字样说明是 64 位 JVM和 x64 包匹配# 查看 JAVA_HOME 是否指向 JDK 根目录不是 bin 目录 echo %JAVA_HOME% # 正确示例C:\Program Files\Java\jdk1.8.0_xxx # 错误示例C:\Program Files\Java\jdk1.8.0_xxx\bin逻辑说明startup.bat内部会调用catalina.bat而catalina.bat会去读JAVA_HOME或JRE_HOME。如果两个都没设脚本会尝试用 PATH 里的java但某些情况下会失败。参数上JAVA_HOME必须指向 JDK 根目录末尾不要带反斜杠也不要用引号包起来除非路径有空格有空格时脚本本身能处理但手动设环境变量时别加引号。如果机器上装了多个 JDK建议在setenv.bat里显式指定而不是依赖全局环境变量。2.2 解压后的目录每个文件夹是干什么的把 zip 解压到一个没有中文、没有空格的路径比如D:\middleware\tomcat-8.5.38。中文路径在 Windows 上偶尔会让日志和临时文件出问题空格路径则可能让某些脚本参数解析出错。解压后你会看到这些目录目录作用能不能随便删bin启动/停止脚本、bootstrap.jar、tomcat-juli.jar不能核心confserver.xml、web.xml、logging.properties等配置不能改之前先备份libTomcat 自身运行依赖的 jar不能除非你清楚在干什么logs运行日志catalina.out在 Windows 上叫catalina.日期.log可清理别删目录temp临时文件JSP 编译产物也在这可清理webapps默认应用部署目录ROOT就是默认首页可清空但 ROOT 删了访问根路径会 404workJSP 编译后的 Servlet 字节码可清理重启会重建这里有个血泪经验conf和webapps在改之前一定要备份。尤其是server.xml改端口、改虚拟主机、加 Connector 都在这里改错一个标签闭合Tomcat 直接起不来而且报错信息往往只告诉你「某行解析失败」不告诉你缺了哪个引号。2.3 默认端口和 Windows 上的占用检查Tomcat 8.5 默认的server.xml里Server的 shutdown 端口是 8005HTTP Connector 是 8080AJP Connector 是 8009。Windows 上 8080 被占用的概率不低常见占用者包括某些开发工具、其他中间件、甚至一些后台服务。# 查看 8080 是否被占用以及占用进程的 PID netstat -ano | findstr :8080 # 最后一列是 PID拿到后查进程名 tasklist | findstr PID逻辑说明netstat -ano列出所有连接和监听端口findstr :8080过滤出 8080 相关行-o参数显示 PID。如果发现被占用要么改 Tomcat 端口要么停掉占用进程。改端口在conf/server.xml里找Connector port8080改成 8081 或别的空闲端口。注意改完端口后如果应用里有硬编码的 8080 回调地址也要一起改否则会出现「服务起来了但接口调不通」的假象。提示AJP 端口 8009 如果你不用 Apache HTTP Server 做前端可以在server.xml里把整个 AJP Connector 注释掉减少一个暴露面也少一个端口冲突源。3. 在 Windows 上把服务跑起来从 startup.bat 到注册成系统服务地基确认完这一章进入实操。目标有两个先用最直接的方式把 Tomcat 跑起来验证包没问题再把它变成开机自启的 Windows 服务适合内网交付和长期运行。中间会讲setenv.bat这个很多人忽略但极其有用的文件。3.1 用 startup.bat 做第一次启动验证最朴素的启动方式就是双击bin\startup.bat但更推荐在命令行里跑这样能看到报错。# 进入 bin 目录 cd /d D:\middleware\tomcat-8.5.38\bin # 启动窗口会停留并输出日志 startup.bat启动后命令行窗口会弹出一个新的窗口显示 Catalina 日志。看到类似Server startup in [xxxx] milliseconds就说明起来了。然后浏览器访问http://localhost:8080能看到 Tomcat 默认首页就对了。逻辑说明startup.bat实际做的是设置CATALINA_HOME和CATALINA_BASE默认都指向解压目录然后调用catalina.bat start。catalina.bat再拼出 Java 启动命令加载bootstrap.jar和tomcat-juli.jar。参数上如果你想让 Tomcat 在前台运行、日志直接打在當前窗口用catalina.bat run而不是startup.bat调试时更方便。如果窗口一闪而过说明启动失败。这时候别反复双击去logs目录看catalina.日期.log或者直接在命令行跑catalina.bat run错误会打在屏幕上。常见原因就三个JAVA_HOME没配、端口被占、server.xml改坏了。3.2 setenv.bat把 JVM 参数和内存配置固定下来bin目录下默认没有setenv.bat但catalina.bat会主动去找它。这个文件是官方推荐的、用来放环境相关配置的地方升级 Tomcat 时不会被覆盖比直接改catalina.bat干净得多。新建bin\setenv.bat内容如下echo off rem 设置 JDK 路径避免依赖全局 JAVA_HOME set JAVA_HOMEC:\Program Files\Java\jdk1.8.0_xxx rem 设置 JVM 内存和常用参数 set JAVA_OPTS-Xms512m -Xmx1024m -XX:MetaspaceSize128m -XX:MaxMetaspaceSize256m set JAVA_OPTS%JAVA_OPTS% -Dfile.encodingUTF-8 set JAVA_OPTS%JAVA_OPTS% -Duser.timezoneAsia/Shanghai rem 设置 Catalina 临时目录避免默认 temp 被系统清理 set CATALINA_TMPDIRD:\middleware\tomcat-8.5.38\temp逻辑说明JAVA_HOME显式指定解决多 JDK 环境下的选择问题。-Xms和-Xmx分别是堆初始值和最大值生产上建议设成一样避免运行中反复扩容带来停顿512m 到 1024m 是中小应用的常见区间具体看应用对象数量和并发。MetaspaceSize和MaxMetaspaceSize控制元空间JDK 8 以后永久代被元空间取代老应用如果动态生成类多这里要给够。-Dfile.encodingUTF-8解决 Windows 默认 GBK 导致的乱码-Duser.timezone解决日志时间差 8 小时的问题。CATALINA_TMPDIR单独指出来是因为 Windows 的临时目录清理策略有时会误删 Tomcat 的 temp导致运行中报文件找不到。注意setenv.bat里的路径如果带空格必须用引号包住整个set VARvalue形式否则set会把空格后的内容当成另一个变量。这是 Windows 批处理的经典坑。3.3 注册成 Windows 服务让 Tomcat 开机自启免安装版默认不是服务关掉命令行窗口服务就停了。要长期运行用bin\service.bat注册。这个脚本依赖prunsrv.exe在bin目录下64 位包自带的是 64 位版本。# 以管理员身份打开命令行进入 bin 目录 cd /d D:\middleware\tomcat-8.5.38\bin # 注册服务服务名 Tomcat85538显示名可自定义 service.bat install Tomcat85538逻辑说明service.bat install后面跟的是服务名不传的话默认用Tomcat8。注册成功后在「服务」管理器里能看到对应条目。启动和停止用# 启动服务 net start Tomcat85538 # 停止服务 net stop Tomcat85538 # 卸载服务改配置或迁移时用 service.bat remove Tomcat85538参数上service.bat会读取setenv.bat里的JAVA_HOME和JAVA_OPTS所以内存配置在服务模式下同样生效。但要注意服务模式下的工作目录和命令行模式不同如果应用里有相对路径读写文件建议全部改成绝对路径否则会出现「命令行能跑、服务跑就报找不到文件」的经典问题。另外服务注册后如果改了setenv.bat需要重启服务才生效不是改完立即生效。4. server.xml 里最该动的几个参数端口、连接器与编码Tomcat 跑起来只是第一步真正决定它稳不稳、快不快的是conf/server.xml。这个文件看着长但日常需要动的就那么几处。这一章按「改哪里、改成什么、为什么」来讲每个参数都给可抄的配置和边界说明。4.1 Connector 的线程模型与 maxThreads 怎么定HTTP Connector 是 Tomcat 处理请求的核心。8.5 默认用的是 NIO 连接器protocolHTTP/1.1在 8.5 里默认走 NIO配置大概长这样Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 maxThreads200 minSpareThreads20 acceptCount100 maxConnections10000 /逻辑说明maxThreads是处理请求的最大工作线程数默认 200。这个值不是越大越好线程太多会加剧 CPU 上下文切换反而拖慢。经验上CPU 密集型应用设成核数的 1 到 2 倍IO 密集型可以到核数的 5 到 10 倍但要在压测里验证。minSpareThreads是最小空闲线程保证突发请求来了不用现创建。acceptCount是等待队列长度当所有工作线程都在忙新连接进这个队列队列满了才会拒绝默认 100高并发场景可以适当加大但加大只是缓冲不是解决根本。maxConnections是同一时刻能接受的最大连接数NIO 模式下可以设得比maxThreads大很多因为连接不一定都在处理。connectionTimeout是连接建立后等待请求的超时默认 20000 毫秒。如果前端有负载均衡这个值要大于负载均衡的健康检查间隔否则健康检查可能被误判为超时。4.2 URIEncoding 和压缩中文参数与传输体积Windows 上部署中文乱码是高频问题。除了前面setenv.bat里的file.encodingConnector 上还要确认URIEncodingConnector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 URIEncodingUTF-8 compressionon compressionMinSize2048 compressableMimeTypetext/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json /逻辑说明URIEncodingUTF-8决定 GET 请求里 URL 参数的解码方式不设的话在 Windows 上可能按 ISO-8859-1 解中文就成乱码。compressionon开启响应压缩compressionMinSize是触发压缩的最小字节数小于这个值不压避免小响应压缩后反而变大。compressableMimeType列出需要压缩的 MIME 类型注意别把图片、视频加进去它们本身已经压缩过再压浪费 CPU。参数边界压缩会消耗 CPU如果服务器 CPU 本来就吃紧或者响应大多是二进制可以关掉。compressionMinSize设 2048 是个折中太小会导致大量小响应走压缩流程收益低。4.3 关闭不必要的 Connector 和自动部署生产环境里AJP 如果不用就注释掉减少一个端口和潜在风险。另外Host标签里的autoDeploy和unpackWARs也值得关注Host namelocalhost appBasewebapps unpackWARstrue autoDeployfalse deployOnStartuptrue逻辑说明autoDeployfalse关闭运行期自动部署避免有人往webapps里丢个 war 就触发重部署生产上这是不稳定因素。deployOnStartuptrue保证启动时把已有应用部署上。unpackWARstrue表示把 war 解压成目录再跑方便看文件如果追求启动速度、不在意目录可以设 false 直接跑 war。改完这些重启 Tomcat 生效。提示每次改server.xml前先复制一份server.xml.bak。Tomcat 对 XML 格式很敏感一个标签没闭合启动直接失败而且日志只报行号不报原因有备份能快速回滚。5. 避坑与排查那些让 Tomcat 起不来或跑不稳的常见问题这一章集中讲踩坑。下面 5 条都是我在 Windows 上部署 8.5.x 时反复遇到的按「现象 → 原因 → 解决」写照着排查能省不少时间。5.1 双击 startup.bat 窗口一闪而过现象双击startup.bat黑窗口闪一下就没了浏览器访问 8080 没反应。原因启动脚本在初始化阶段就失败了最常见的是JAVA_HOME没配或指向错误其次是CATALINA_HOME路径含空格或中文导致脚本解析异常。解决不要双击在命令行里跑catalina.bat run错误会直接打在屏幕上。如果是JAVA_HOME问题在setenv.bat里显式指定。如果是路径问题把 Tomcat 移到纯英文无空格路径比如D:\middleware\tomcat-8.5.38。5.2 8080 端口被占用启动报 Address already in use现象日志里出现java.net.BindException: Address already in use: JVM_Bind服务起不来。原因8080 或 8005 被其他进程占用。Windows 上 8080 常被其他 Web 工具占用8005 偶尔被安全软件占用。解决用netstat -ano | findstr :8080找到 PIDtasklist | findstr PID确认进程。能停就停不能停就改 Tomcat 端口。改server.xml里的 Connector port 和 Server port两个都要改只改一个另一个还会冲突。5.3 服务模式启动后应用读写文件报找不到路径现象命令行startup.bat跑得好好的注册成 Windows 服务后应用里读写相对路径的文件全部失败。原因Windows 服务的工作目录默认是C:\Windows\System32不是 Tomcat 的bin目录。应用里如果用相对路径基准就变了。解决把应用里所有文件路径改成绝对路径或者在service.bat注册时通过--StartPath指定工作目录部分版本支持。更稳妥的做法是应用配置里用${catalina.base}这类变量拼绝对路径。5.4 日志时间比实际时间差 8 小时现象logs里的日志时间戳比北京时间早 8 小时排查问题时对不上时间线。原因JVM 默认时区是 UTCWindows 上 Tomcat 启动时没有继承系统时区设置。解决在setenv.bat的JAVA_OPTS里加-Duser.timezoneAsia/Shanghai。如果已经起了服务改完要重启服务。另外logging.properties里的时间格式也可以确认一下但根因在 JVM 时区。5.5 内存溢出日志报 OutOfMemoryError: Metaspace现象运行一段时间后应用无响应日志里出现java.lang.OutOfMemoryError: Metaspace。原因JDK 8 的元空间默认没有上限受物理内存限制但如果setenv.bat里设了MaxMetaspaceSize且偏小动态生成类多的应用比如大量 JSP、反射、代理就会撑爆。解决适当调大-XX:MaxMetaspaceSize比如从 256m 调到 512m同时观察是否真的需要这么大。如果持续增长不回收要排查应用是否有类加载器泄漏比如热部署反复加载同一个类。临时缓解可以调大根治要查代码。6. 让这个老版本跑得更稳日志分级、连接池与版本锁定到这一步Tomcat 已经能跑、能自启、参数也调过一轮了。最后这一章讲几个进阶但很实用的技巧都是围绕「怎么在不能随便升级的前提下把这个 8.5.38 用得更久、更稳」。第一个技巧是日志分级。Tomcat 默认的logging.properties把很多信息打在 INFO 级别日志增长很快。内网长期运行的话建议把org.apache.catalina调到 WARNING只保留必要信息同时给catalina日志配按天滚动。具体在conf/logging.properties里改# 降低 catalina 核心包的日志级别减少日志量 org.apache.catalina.level WARNING # 保留连接器和容器启动信息方便确认启动状态 org.apache.catalina.startup.level INFO # 文件处理器按天滚动保留 30 天 1catalina.org.apache.juli.AsyncFileHandler.maxDays 30逻辑说明org.apache.catalina.level WARNING会过滤掉大量 INFO 级别的请求处理日志日志体积能降一个数量级。maxDays控制保留天数避免磁盘被日志占满。改完重启生效。注意别把级别调太高否则出问题时没有足够上下文。第二个技巧是数据库连接池的验证查询。老应用常用 DBCP 或 Tomcat JDBC Pool内网数据库如果会主动断开空闲连接连接池里的连接会变成死连接应用报Connection reset。在context.xml里给 Resource 加验证配置Resource namejdbc/app authContainer typejavax.sql.DataSource maxTotal50 maxIdle10 minIdle5 validationQuerySELECT 1 testWhileIdletrue timeBetweenEvictionRunsMillis30000 removeAbandonedOnBorrowtrue removeAbandonedTimeout300 /逻辑说明validationQuery是验证连接是否存活的 SQLtestWhileIdle表示空闲时检测timeBetweenEvictionRunsMillis是检测间隔。removeAbandonedOnBorrow和removeAbandonedTimeout用来回收被应用忘记关闭的连接防止连接池被耗尽。参数上maxTotal要根据数据库的最大连接数和应用并发来定不是越大越好50 是个常见起点。第三个技巧是版本锁定与备份。既然专门找 8.5.38说明版本敏感。建议把整个解压目录打包备份一份连同setenv.bat、server.xml、context.xml一起。以后要迁移或重建直接解压备份包改一下JAVA_HOME和端口就能用不用重新调参数。同时记录下当前用的 JDK 具体版本因为 JDK 小版本升级有时也会影响 TLS 握手和类加载行为。最后一个习惯任何改动前先停服务、备份配置、改完看日志确认启动成功再离开。我吃过一次亏改完server.xml直接重启服务结果标签写错服务起不来半夜被叫起来回滚。从那以后改配置必留.bak重启必看catalina日志前 50 行。这个习惯比任何参数都值钱。希望帮到你。本文还有配套的精品资源点击获取