简介Apache Tomcat 7.0.108 是一款开源的 Java Servlet 容器主要用于运行 JSP 与 Servlet 等 Java Web 应用。这份 zip 压缩包面向 Java Web 开发者、运维人员及计算机专业学生帮助其快速搭建本地服务器环境完成 Web 项目的部署、调试与运行。包内共 640 个文件约 10.38MB以 html、class、java、jsp 等源码与页面文件为主同时包含 jar 库、xml 与 properties 配置、bat 与 sh 启停脚本以及 gif、png 等静态资源完整覆盖 bin、conf、lib、webapps 等核心目录结构。资源中附带的部署说明与配置示例可帮助读者理解 WAR 包发布、Context 配置、日志查看及 manager 管理工具的使用方式便于对照排查端口占用、环境变量设置等常见问题。目前已有 633 人学习下载适合需要掌握 Tomcat 部署流程与目录机制的初、中级开发者参考使用。1. Tomcat 7.0.108 这个老版本为什么还有人专门找它上周有个做遗留系统维护的读者问我他们一套跑了七八年的内部管理系统要迁移到新服务器代码是 Servlet 2.5 JSP 写的用 Tomcat 8 启动就报NoSuchMethodError换回 7.0.x 就正常。他找了一圈发现 Tomcat 7 的官方归档里 7.0.108 是最后一个版本但网上要么是残缺的安装包要么是被人塞了东西的“绿色版”。他想要一个干净的、能直接解压用的tomcat-7.0.108.zip。这个需求其实很典型。Tomcat 7.0.108 是 Apache Tomcat 7.x 分支的收官版本2013 年发布 7.0.0到 2021 年 3 月发布 7.0.108 后正式停止维护。它实现的是 Servlet 3.0、JSP 2.2、EL 2.2 规范支持 WebSocket 1.1JDK 最低要求 1.6跑在 JDK 8 上也没问题。很多老项目、教学环境、嵌入式设备的管理后台至今还锁死在这个版本上因为升级 Servlet 版本意味着要改web.xml的 schema、换掉一批废弃 API、重新测一遍过滤器链成本远高于继续用旧容器。这份tomcat-7.0.108.zip就是那个“最后一版”的完整二进制分发包。解压出来是标准的 Tomcat 目录结构bin放启动脚本conf放server.xml、web.xml、tomcat-users.xmllib放核心 jarwebapps放默认应用logs和temp运行时生成。它适合三类人维护遗留 Java Web 项目的后端需要固定容器版本做兼容性测试的测试岗以及教学场景里要给学生一个“不依赖 IDE 就能跑起来”的 Servlet 容器。下面我从目录结构、配置改法、部署方式到常见报错把这套东西拆一遍。2. 解压之后先别急着 startup目录结构与三个核心配置文件2.1 目录里哪些能动、哪些别碰拿到 zip 之后我一般先解压到一个不带空格和中文的路径比如D:\server\tomcat7或/opt/tomcat7。Windows 下如果路径里有空格catalina.bat里某些引号处理会出玄学问题这是血泪经验。解压完先看目录目录作用是否建议改动bin启动/停止脚本、bootstrap.jar、tomcat-juli.jar不改除非要调 JVM 参数conf全局配置server.xml是核心按需改改前备份lib容器运行依赖的 jar不删可追加 JDBC 驱动webapps默认部署目录可清空放自己的 warlogs日志输出不手动建启动自动生成temp临时文件可定期清workJSP 编译后的 class出问题可整个删掉重编译bin目录下 Windows 用startup.bat/shutdown.batLinux 用startup.sh/shutdown.sh。注意startup.sh本质是调catalina.sh start真正干活的是catalina.sh。如果你要改 JVM 内存别去动startup.sh在catalina.sh开头加JAVA_OPTS或者用setenv.shLinux/setenv.batWindows单独放这样升级容器时配置不会丢。2.2 server.xml 里改哪几个端口和 Connectorconf/server.xml是 Tomcat 的主配置。默认监听 8080如果被占改Connector port8080 ...里的 port。常见做法是同时改SHUTDOWN端口默认 8005避免和别的实例冲突!-- conf/server.xml 片段 -- Server port8005 shutdownSHUTDOWN Service nameCatalina !-- 把 8080 改成 8081避免和已有服务冲突 -- Connector port8081 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 / Engine nameCatalina defaultHostlocalhost Host namelocalhost appBasewebapps unpackWARstrue autoDeploytrue /Host /Engine /Service /ServerconnectionTimeout单位毫秒20000 是 20 秒内网系统可以调到 30000。redirectPort是当请求需要 SSL 时跳转的端口没配 HTTPS 就保持默认。unpackWARstrue表示 war 包会自动解压成目录方便看编译后的 JSPautoDeploytrue表示容器运行期间丢 war 进去会自动部署生产环境我一般关掉改成手动部署避免误操作。2.3 tomcat-users.xml 加管理账号Tomcat 7 默认的 manager 和 host-manager 应用需要登录。conf/tomcat-users.xml里默认是注释掉的要自己加角色和用户!-- conf/tomcat-users.xml -- tomcat-users !-- manager-gui 能访问 HTML 管理界面manager-script 供脚本调用 -- role rolenamemanager-gui/ role rolenamemanager-script/ user usernameadmin passwordChangeMe_2024 rolesmanager-gui,manager-script/ /tomcat-usersmanager-gui对应/manager/html页面manager-script对应/manager/text接口用 curl 或 ant 做自动化部署时需要后者。密码别用默认的也别用纯数字Tomcat 7 的 manager 对弱密码没有强制校验但暴露在公网就是灾难。改完tomcat-users.xml不需要重启manager 应用会热加载但server.xml改了必须重启。3. 启动、部署与日志排查从 startup 到第一个 war 跑起来3.1 启动脚本与 JVM 参数怎么设Linux 下先给脚本执行权限再启动# 进入解压目录 cd /opt/tomcat7 # 给 bin 下所有 sh 脚本加执行权限 chmod x bin/*.sh # 启动startup.sh 会调 catalina.sh start ./bin/startup.sh # 确认进程和端口 ps -ef | grep tomcat netstat -tlnp | grep 8081如果内存不够在bin/setenv.sh里写# bin/setenv.shTomcat 启动时会自动 source 这个文件 export JAVA_OPTS-Xms512m -Xmx1024m -XX:PermSize128m -XX:MaxPermSize256m -Dfile.encodingUTF-8注意 Tomcat 7 跑在 JDK 8 上时PermSize和MaxPermSize已经被元空间取代JDK 8 会打印警告但不影响运行如果跑在 JDK 7 上这两个参数是有效的。-Dfile.encodingUTF-8很关键老项目里 JSP 页面中文乱码十有八九是启动时没指定编码或者server.xml的 Connector 没加URIEncodingUTF-8。3.2 部署 war 包的三种方式第一种直接丢文件。把myapp.war复制到webapps下如果autoDeploytrue几秒后日志会打印部署信息访问http://localhost:8081/myapp。第二种用 manager 页面上传。浏览器打开http://localhost:8081/manager/html输入tomcat-users.xml里配的账号在“WAR file to deploy”区域选文件上传。第三种用 manager-script 接口做自动化# 用 curl 通过 manager-script 部署-T 上传 war curl -u admin:ChangeMe_2024 \ -T ./target/myapp.war \ http://localhost:8081/manager/deploy?path/myappupdatetrue # 查看已部署应用列表 curl -u admin:ChangeMe_2024 \ http://localhost:8081/manager/text/listpath/myapp指定上下文路径updatetrue表示已存在则覆盖。这种方式适合 CI 里做自动发布不用手动登录页面。注意 manager-script 的 URL 前缀是/manager/text不是/manager/html写错了会返回 404。3.3 日志在哪、怎么看Tomcat 7 的日志分几类logs/catalina.out是标准输出和错误logs/localhost.YYYY-MM-DD.log是应用级日志logs/localhost_access_log.YYYY-MM-DD.txt是访问日志。启动失败先看catalina.out最后 50 行# 实时跟踪启动日志 tail -f logs/catalina.out # 只看错误和异常 grep -E SEVERE|Exception|Error logs/catalina.out | tail -30常见启动失败原因端口被占Address already in use、JAVA_HOME没设或指向 JRE 而非 JDKNeither the JAVA_HOME nor the JRE_HOME environment variable is defined、webapps下 war 包损坏导致解压失败。如果是java.lang.OutOfMemoryError: PermGen space说明类加载太多调大MaxPermSize或检查是否有重复部署。4. 避坑与排查Tomcat 7 上最容易翻车的五个点4.1 中文乱码GET 请求参数变问号现象JSP 页面表单用 GET 提交后台request.getParameter()拿到的是乱码。原因Tomcat 7 的 HTTP Connector 默认URIEncoding是 ISO-8859-1不是 UTF-8。解决在server.xml的 Connector 上加URIEncodingUTF-8重启。POST 请求则要在取参数前调request.setCharacterEncoding(UTF-8)或者用 Spring 的CharacterEncodingFilter。4.2 JSP 编译报错Unable to compile class for JSP现象访问 JSP 报 500日志里Unable to compile class for JSP下面跟着cannot find symbol。原因JSP 里用了 JDK 高版本才有的语法或类但 Tomcat 7 的 JSP 编译器默认按 Servlet 3.0 / JSP 2.2 规范编译且work目录里缓存了旧的编译结果。解决先删work/Catalina/localhost/应用名整个目录强制重新编译再检查 JSP 里是否用了菱形泛型Java 7 语法Tomcat 7 默认编译器可能不认改成显式类型。4.3 内存溢出PermGen space 与 Metaspace现象运行一段时间后java.lang.OutOfMemoryError: PermGen space。原因Tomcat 7 在 JDK 7 下用永久代存类元数据频繁热部署会导致 PermGen 被撑满。解决JDK 7 下加-XX:MaxPermSize256mJDK 8 下永久代已移除报的是Metaspace加-XX:MaxMetaspaceSize256m。更根本的办法是减少热部署次数生产环境别开autoDeploy。4.4 端口冲突8005 被占导致 shutdown 失败现象执行shutdown.sh后进程还在日志显示java.net.BindException: Address already in use。原因server.xml里Server port8005的关闭端口被另一个 Tomcat 实例或别的程序占了。解决改server.xml里的port为其他值如 8006或者直接用kill -9杀进程不推荐可能丢数据。多个 Tomcat 实例在同一台机器上时8005、8080、8009 三个端口都要错开。4.5 安全漏洞7.0.108 之后不再有补丁现象扫描工具报 Tomcat 7 存在 CVE 漏洞。原因7.0.108 是 7.x 最后一个版本2021 年 3 月之后 Apache 不再为 7.x 发布安全补丁后续发现的漏洞不会修复。解决如果项目必须用 Servlet 3.0至少把 Connector 的server属性改掉隐藏版本号关闭不必要的 AJP 连接器Connector port8009 protocolAJP/1.3 /如果不用就注释掉manager 应用只在内网访问。长期看还是要规划升级到 Tomcat 9 或 10。5. 进阶技巧用 CATALINA_BASE 跑多实例与版本验证5.1 一套二进制跑多个实例Tomcat 7 支持CATALINA_HOME和CATALINA_BASE分离。CATALINA_HOME指向解压出来的公共目录CATALINA_BASE指向每个实例自己的配置和部署目录。这样一份tomcat-7.0.108.zip可以跑多个互不干扰的实例省磁盘也省升级成本。做法是复制conf、logs、temp、webapps、work到实例目录然后# 实例 1 的启动脚本 export CATALINA_HOME/opt/tomcat7 export CATALINA_BASE/opt/instances/app1 export JAVA_OPTS-Xms256m -Xmx512m $CATALINA_HOME/bin/startup.sh # 实例 2端口在各自 conf/server.xml 里错开 export CATALINA_BASE/opt/instances/app2 $CATALINA_HOME/bin/startup.sh每个实例的server.xml里 8005、8080、8009 都要不同。bin和lib共用CATALINA_HOME下的不用复制。这样升级时只换CATALINA_HOME实例配置不动。5.2 验证版本与规范支持启动后想确认跑的是不是 7.0.108看logs/catalina.out开头# 查看启动版本信息 head -20 logs/catalina.out | grep Server version # 输出类似Server version: Apache Tomcat/7.0.108或者访问http://localhost:8081/默认页会显示版本号。要确认 Servlet 版本看lib/servlet-api.jar里的MANIFEST.MF或者写一个最简单的 Servlet 打印getServletContext().getMajorVersion()和getMinorVersion()Tomcat 7 返回 3 和 0。JSP 版本在conf/web.xml的jsp-config里能看到version2.2。5.3 一个我常做的兼容性自检每次拿到一个老项目的 war我会先做三件事第一解压 war 看WEB-INF/web.xml的web-app版本如果是 2.5 或 3.0Tomcat 7 都能跑如果是 3.1Tomcat 7 不支持得换 8。第二看WEB-INF/lib里有没有javax.servlet-api的 jar有的话删掉否则和容器自带的冲突报ClassCastException。第三启动后访问一个核心页面看logs/localhost.*.log有没有NoSuchMethodError这通常是编译时用的 Servlet API 版本比运行时高。从那以后我每次拿到一个老 war 包都强制走一遍这三步自检再决定用哪个版本的容器。希望这份 7.0.108 的拆解能帮到你少走点版本兼容的弯路。本文还有配套的精品资源点击获取