简介Tomcat 8.5 是 Apache 基金会的稳定版 Java Servlet 容器提供 Windows 与 macOS 下的 32/64 位构建适合 Java Web 开发者和运维人员搭建跨平台运行环境。资源包共 1277 个文件约 29.98MB主要包含 html 页面、jsp 动态页、class 类、java 源码、jar 库和 xml 配置辅以 sh/bat 启动脚本、txt 说明及 gif/png 素材覆盖运行、开发与文档场景。已有 248 人学习下载。包内采用标准 Tomcat 目录bin 含启停脚本conf 提供 server.xml 等配置示例webapps 可直放 WAR 包logs 与 work 便于日志和 JSP 编译排错。借助该资源用户可掌握从解压安装、环境变量配置到应用发布与端口修改的完整流程适合入门 Servlet/JSP 或需要跨平台 Tomcat 环境的开发者。 Tomcat 8.5 在 Windows 和 Mac 上的安装确实不算难但里面坑不少。尤其是 32 位和 64 位的选择、JDK 版本匹配、环境变量配置这几个点稍不注意就会浪费一晚上。这篇就按我实际部署过多次的经验把从下载到跑起来的完整链路捋一遍顺便把我踩过的坑和排查思路也交代清楚。1. 版本选择Tomcat 8.5 为什么还值得用以及 32/64 位怎么选先说 Tomcat 8.5 本身。它发布于 2016 年但在生产环境里存量很大尤其是配合 JDK 8 的老项目。8.5 这个版本横跨了 Servlet 3.1 规范的成熟期支持 HTTP/2、NIO 2 等特性稳定性经过了多年验证。很多公司不愿意升级到 Tomcat 9 或 10就是因为包名变更javax 到 jakarta会引发一堆兼容性问题。所以 Tomcat 8.5 在短期内依然是 Windows 和 Mac 上跑 Java Web 应用的稳妥选择。真正容易让人懵的是 32 位和 64 位版本的选择。这里有个关键认知Tomcat 本身是纯 Java 写的它的压缩包是平台无关的没有 Win32 或 Win64 之分。Windows 安装包区分 32/64 位核心在于两点32 位版本内置的tomcat8.exe服务包装器是 32 位编译的适合 32 位 JDK。64 位版本内置的tomcat8.exe是 64 位编译的必须配 64 位 JDK。换句话说如果你的 JDK 是 64 位的就选 64 位安装包JDK 是 32 位的就选 32 位安装包。如果 JDK 和 Tomcat 服务包装器位数不匹配启动时通常会报“Failed to initialize”之类的错误或者服务根本起不来。那怎么看自己的 JDK 位数在命令行执行java -version如果输出里带64-Bit说明是 64 位 JDK。比如java version 1.8.0_202 Java(TM) SE Runtime Environment (build 1.8.0_202-b512) Java HotSpot(TM) 64-Bit Server VM (build 25.202-b512, mixed mode)再或者执行java -d64 -version32 位 JDK 会报“不支持的选项”64 位则正常显示版本信息。我的建议是新环境一律使用 64 位 JDK 8 64 位 Tomcat 8.5。32 位 JDK 有内存上限问题堆内存最多只能用到 1.5GB 左右生产环境根本不够看。你要是自己学习用内存不超过 4GB 的旧电脑32 位勉强能跑但完全不推荐。macOS 这边就没有 32/64 位的烦恼了。Mac 的 Tomcat 发行版只有一个通用 tar.gz 压缩包因为从 macOS Catalina 开始系统强制 64 位应用JDK 也只有 64 位版不存在选择问题。安装时只需要确保 JDK 版本匹配即可。2. 环境准备JDK 版本匹配是第一优先级Tomcat 8.5 对 Java 版本的要求很明确最低 Java 7推荐 Java 8最高支持到 Java 11。如果你用的是 JDK 17 或者更高版本Tomcat 8.5 跑不起来会报UnsupportedClassVersionError或者直接启动失败。这里有读者可能会问为什么 JDK 17 不行因为 Tomcat 8.5 的字节码版本最高支持到 Java 11 对应的 class 文件版本55.0JDK 17 编译出来的类是 61.0Tomcat 的类加载器读不了。所以装 Tomcat 8.5 之前先确认你机器上的 JDKjava -version javac -version如果之前装过 JDK 17 或更高版本我建议再装一个 JDK 8两台 JDK 共存也没有问题。Windows 上可以手动切换JAVA_HOME环境变量Mac 上可以用export JAVA_HOME$(/usr/libexec/java_home -v 1.8)临时切换。JDK 8 的下载地址Windows 用户建议直接去 Oracle 官网下载jdk-8uXXX-windows-x64.exe。Mac 用户下载jdk-8uXXX-macosx-x64.dmg安装即可。注意 Oracle JDK 8 的更新版本已经停止免费商用授权个人学习使用没问题公司环境建议用 OpenJDK 8比如 Adoptium 的 Temurin 8。我这里说下 Mac 上的一个小坑如果你下载的是 ARM 版 JDKM1/M2 芯片而 Tomcat 想跑 x86 架构的本地库可能会有兼容问题。不过 Tomcat 是纯 Java一般没事。保险起见 Mac 上装 Temurin 8 的 x64 版本配合 Rosetta 2 跑最省心。3. Windows 安装实操32/64 位安装包的选择与手动配置Windows 上装 Tomcat 有两种形态安装版exe 安装程序和压缩版zip 解压即用。3.1 安装版 vs 压缩版怎么选安装版会把 Tomcat 注册成 Windows 服务开机自启适合生产环境挂服务。压缩版更适合开发调试因为不污染系统服务删了压缩包就干净了。我的经验是个人开发用压缩版服务器部署用安装版。压缩版出问题了好排查不会出现服务残留。3.2 压缩版zip安装步骤去 Tomcat 官网下载apache-tomcat-8.5.100-windows-x64.zip版本号以实际为准解压到纯英文路径比如D:\dev\apache-tomcat-8.5.100。路径里绝对不能有中文和空格否则后期catalina.bat能启动但部署的项目读取文件路径时大概率踩坑。配置JAVA_HOME环境变量指向 JDK 的安装根目录比如C:\Program Files\Java\jdk1.8.0_202。双击bin\startup.bat看到Server startup in [xxx] milliseconds就成功了。浏览器访问http://localhost:8080看到 Tomcat 默认页面就说明没问题。3.3 安装版exe的具体细节安装版在安装过程中会让你选择 JRE 路径这时候别被带偏。它会自动检测系统里的 JRE但如果你只装了 JDK 没装 JRE它可能识别不到。实际测试中发现安装版最好先装好 JDK再装 Tomcat它自动识别JAVA_HOME的成功率最高。另外安装版在配置端口、用户名和密码时HTTP/1.1 Connector Port 默认 8080如果被占用改成 8081 或 9090。用户名和密码是 Tomcat Manager 的管理账号我建议第一次装的时候直接填一个复杂的密码后续就不用再改tomcat-users.xml了。安装完服务后打开services.msc能看到 Apache Tomcat 8.5 服务右键启动即可。这里有读者可能会遇到“服务启动后又自动停止”的问题。大概率是端口被占用或 JDK 环境变量没配对。排查方法后面会详细说。3.4 32 位系统的特殊注意如果你的 Windows 还是 32 位系统非常老的机器下载时记得选windows-x86.zip不要选windows-x64.zip。同时 JDK 也得装 32 位版本。用 64 位浏览器访问 Tomcat 的 8080 端口倒是没影响因为 Tomcat 是纯 Java 服务端口监听和位数无关。Windows 32 位系统的最大问题是内存受限Tomcat 默认的catalina.bat内存参数别调太大-Xmx512m就够用了。调大了反而会因为虚拟内存不足导致频繁 Full GC。4. Mac 安装实操tar.gz 解压与 Homebrew 两种方式Mac 用户装 Tomcat 8.5 的思路和 Windows 完全不同。没有安装版的概念本质上是解压一个 tar.gz 包然后执行启动脚本。4.1 方式一官网下载 tar.gz这是最通用的方式适用于任何 Mac 机型。# 下载以 8.5.100 为例版本号请按实际更新 curl -O https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.100/bin/apache-tomcat-8.5.100.tar.gz # 解压 tar -zxvf apache-tomcat-8.5.100.tar.gz # 移动到统一管理目录可选 mv apache-tomcat-8.5.100 /usr/local/tomcat8解压完成后进入bin目录cd /usr/local/tomcat8/bin ./startup.sh启动成功后控制台会打印Tomcat started.如果提示Permission denied是因为没有执行权限需要chmod x *.shmacOS 上还有一个隐藏问题如果你是从浏览器下载的 tar.gz系统会标记为“来自互联网”首次执行startup.sh可能被 Gatekeeper 拦截。处理方法是在“系统设置 - 隐私与安全性”里点“仍要打开”或者在终端执行xattr -d com.apple.quarantine /usr/local/tomcat8/bin/startup.sh4.2 方式二Homebrew 安装Homebrew 安装最大的好处是省去了环境变量配置和目录管理但注意Homebrew 默认安装的 Tomcat 可能是最新版本10.x不是 8.5。所以直接brew install tomcat是不行的你需要指定版本brew tap homebrew/services brew install tomcat8如果tomcat8这个 formula 不可用就用brew install homebrew/versions/tomcat8装完后配置文件在/usr/local/etc/tomcat8/启动命令是brew services start tomcat8或者不用开机自启/usr/local/opt/tomcat8/bin/startup.sh这里有个大坑Homebrew 装的 Tomcat 8.5 的端口配置文件在/usr/local/etc/tomcat8/server.xml不是 Tomcat 安装目录下的conf/server.xml。第一次我找配置找了半天因为路径和官网文档完全对不上。4.3 Mac 上 JDK 路径的坑Mac 的 JDK 路径和 Windows 完全不同JAVA_HOME不是固定的。你执行/usr/libexec/java_home它会输出当前默认 JDK 的路径比如/Library/Java/JavaVirtualMachines/jdk1.8.0_202.jdk/Contents/Home。Tomcat 的startup.sh会通过which java和JAVA_HOME两个途径找 Java。如果你之前用 SDKMAN 或手动改过~/.zshrc里的JAVA_HOME可能会导致 Tomcat 拿到错误版本的 JDK。我建议在~/.zshrc里显式声明export JAVA_HOME$(/usr/libexec/java_home -v 1.8) export CATALINA_HOME/usr/local/tomcat8然后source ~/.zshrc这样能保证 Tomcat 8.5 用的 JDK 是 1.8同时和 Maven 也能对齐版本不会出现“Maven 编译用的是 JDK8Tomcat 运行却找了 JDK17”的诡异问题。5. 启动验证与常见问题排查Tomcat 装好后第一步先验证基础启动。Windows 浏览器访问http://localhost:8080Mac 也一样。能看到那只猫的默认首页说明 Tomcat 本体没问题。5.1 默认启动失败排查问题 1端口 8080 被占用最常见。Windows 用netstat -ano | findstr 8080Mac/Linux 用lsof -i :8080如果看到 PID要么杀掉进程要么改 Tomcat 的端口。改端口的位置在conf/server.xmlConnector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /把port8080改成port8081之类的即可。问题 2JAVA_HOME 没有配置或配置错误Windows 终端执行echo %JAVA_HOME%Mac 执行echo $JAVA_HOME。如果输出为空说明没配置或没生效。Windows 上配置了系统环境变量后需要重新开终端Mac 上记得source ~/.zshrc。问题 3Catalina 日志里有Unable to process classes或ClassNotFound这类问题多半是 JDK 版本太高。把 JAVA_HOME 指向 JDK 8 再试一次。5.2 开发环境启动速度优化很多人觉得 Tomcat 启动慢其实大部分时间是花在类扫描和 jar 包解析上。如果只是做日常开发可以打开 Tomcat 的 NIO 配置在server.xml的连接器上加上protocolorg.apache.coyote.http11.Http11Nio2ProtocolWindows 和 Mac 对 NIO2 的支持都不错实际测试中启动速度提升不算特别大但并发连接处理性能会好一点。另外可以在catalina.properties里调整tomcat.util.scan.StandardJarScanFilter.jarsToSkip把不常用的 jar 包加进去跳过扫描。这个文件在conf/catalina.propertiestomcat.util.scan.StandardJarScanFilter.jarsToSkip*.jar注意*.jar表示跳过所有 jar 扫描只适合快速开发验证正式部署不要这么激进否则可能导致部分注解识别不到。5.3 Windows 上部署 Maven 项目需要注意的路径问题如果你是在 Windows 上用 Maven 构建项目后部署到 Tomcat最好通过 IDE 的 Run Configuration 来启动 Tomcat或者把target目录下生成的 war 包拷贝到webapps目录下而不是直接改 IDE 的 output 目录。我之前踩过一个坑用 IDEA 启动 Tomcat部署方式选的是war exploded结果 Tomcat 8.5 在 Windows 下的临时文件路径C:\Users\xxx\.IntelliJIdea2019.3\system\tomcat\Tomcat_8_5_xxx\work会缓存旧 class 文件。后面改了代码不生效Flush 了好多遍才发现是 IDE 的临时文件缓存问题。解决办法是改 IDEA 中 Tomcat 配置的 Working directory或者直接删掉那个临时 work 目录再启动。6. 日常管理小技巧与优化配置Tomcat 跑起来只是第一步日常管理有几个小技巧值得收藏。6.1 Windows 开机自启配置如果你在 Windows 上用的是压缩版 Tomcat想开机自启可以手动注册 Windows 服务。管理员权限打开命令行进入 Tomcat 的bin目录service.bat install Tomcat8然后去services.msc里把启动类型改成“自动”。卸载服务用service.bat remove Tomcat86.2 Mac 开机自启配置Mac 用户如果希望 Tomcat 开机自启用 Homebrew services 最方便brew services start tomcat8它会注册一个 LaunchAgent开机自动拉起来。6.3 内存参数优化Tomcat 默认的内存配置在bin/catalina.shMac或bin/catalina.batWindows里在文件开头加上Mac/LinuxCATALINA_OPTS-Xms512m -Xmx1024m -XX:MaxMetaspaceSize256mWindowsset CATALINA_OPTS-Xms512m -Xmx1024m -XX:MaxMetaspaceSize256m对应关系很简单-Xms是初始堆内存-Xmx是最大堆内存。生产环境建议-Xms和-Xmx设成一样避免运行时动态扩缩容带来的性能抖动。32 位系统上-Xmx不要超过 1.5G。6.4 查看 Tomcat 运行日志写代码一时爽排查火葬场。Tomcat 的日志在logs目录下catalina.out或catalina.YYYY-MM-DD.log记录核心启动和运行日志。localhost.YYYY-MM-DD.log记录应用抛出的异常和堆栈信息。manager.YYYY-MM-DD.log记录 Manager 模块的访问日志。日常排查优先看catalina.out它会把 stderr 和 stdout 合并输出信息量最大。7. 把 Tomcat 8.5 和常见工具的联动经验如果你的开发环境里还有 Maven、Docker 这些工具Tomcat 8.5 和他们之间的协作也有几个值得注意的地方。7.1 Maven Tomcat 8.5Maven 项目在pom.xml里配tomcat7-maven-plugin比较常见但 8.5 也能用这个插件跑。不过生产环境直接用 IDEA 配 Run Configuration 连接 Tomcat 更省事。Maven 编译打包时注意 target 目录的打包格式Tomcat 8.5 支持标准 war 包也支持 exploded 目录。用 exploded 目录部署在调试阶段能省掉反复打包的时间。7.2 Docker Tomcat 8.5如果你习惯用 Docker 起 Tomcat镜像名注意区分架构。tomcat:8.5.100-jdk8是官方镜像同时有 amd64 和 arm64 版本Mac M1 上用这个镜像没问题。不过有一个常见场景本机装了 Tomcat 8.5但用 Docker 跑了一个tomcat:8.5容器两边端口冲突。这时候最直接的办法是改宿主机 Tomcat 的端口或者 Docker 映射时换宿主机端口比如-p 8081:8080。7.3 Redis 和 Tomcat 的 Session 共享如果你在部署时用到 Redis 做 Session 共享Tomcat 8.5 默认是不支持的。需要引入tomcat-redis-session-manager之类的第三方依赖。这个配置比较复杂涉及context.xml修改和依赖 jar 放入lib目录。我的经验是先把 Tomcat 单机跑通了再考虑 Session 共享不要一上来就搞复杂架构。否则出问题时根本分不清是 Tomcat 的问题还是 Redis 的问题。8. 几个实操小细节补充装 Tomcat 这件事看着是下载、解压、启动三个步骤但实际操作中有几个小细节知道的人不说不知道的人要折腾很久。第一Windows 的杀毒软件和防火墙可能会拦 Tomcat 的启动脚本。我之前装 8.5.50 时某杀毒软件直接隔离了tomcat8.exe导致服务安装完启动秒退。如果你遇到“服务启动后又自动停止”先检查是不是被杀毒软件隔离了。第二Mac 上从官网下载 tar.gz 解压后如果/usr/local目录权限不是当前用户所有会出现各种 Permission denied。建议用 Homebrew 安装或者干脆把 Tomcat 解压到用户目录下别放到系统保护的目录里。第三catalina.bat里不要手动写死JAVA_HOME的值。有人为了方便直接把set JAVA_HOMEC:\Program Files\Java\jdk1.8.0_202写进脚本当前是能跑但以后 JDK 路径一变就要改脚本而且容易和系统环境变量冲突。正确做法是只在系统环境变量里配置一次JAVA_HOME脚本里什么都不用动。第四JDK 17 和 Tomcat 8.5 的兼容性问题真实存在。Windows 上有用户用 JDK17 启动 Tomcat 8.5结果报了java.lang.NoClassDefFoundError: javax/annotation/Resources这个就是 JDK 版本太高导致javax.annotation模块被移除。出现这种情况不是 Tomcat 坏了是你必须换 JDK 8。第五Mac 上的.DS_Store文件会让 Tomcat 扫描到莫名其妙的路径。如果你是在 Mac 上开发然后通过 SMB 或 U 盘把项目拷贝到 Windows 上部署记得把隐藏的.DS_Store文件删干净否则有些部署工具会尝试打包这些文件导致 war 包里有垃圾文件。我自己的开发机装的是 Windows 11生产服务器是 CentOS公司配了一台 Mac mini 做移动开发。三套环境下 Tomcat 8.5 我都实际部署过Windows 上用 64 位 zip 包最顺手Mac mini 上用 Homebrew 最省事生产服务器用 tar.gz 解压到/opt目录并手动注册 systemd 服务。每个平台的细节差异其实都不大只要你把 JDK 版本和位数认准了Tomcat 本身是很稳定的。总结下来Tomcat 8.5 的安装选型核心就是JDK 8 64 位Windows/通用 tar.gzMac。先确认 JDK再下载对应版本然后按上面步骤操作基本十分钟内就能跑起来。如果还有特殊情况比如 mac M1 上startup.sh启动失败、Windows 服务怎么都注册不上欢迎在评论区留言我看到会第一时间回复。本文还有配套的精品资源点击获取