如何升级Java Tomcat到最新版本

升级前准备与版本选择

• 明确“最新版本”的含义：同系列的最新小版本（如 8.5.x → 8.5.y）与大版本（如 8.5 → 9.0/10.1/11.0）升级路径不同，风险也不同。优先选择当前系列的最新小版本以快速修复漏洞；跨大版本需评估兼容性。
• 核对 JDK 与 Tomcat 的兼容矩阵，避免版本不匹配导致启动失败或运行异常：
  • Tomcat 11.0.x → JDK 21+
  • Tomcat 10.1.x → JDK 11+
  • Tomcat 9.0.x → JDK 8+
  • Tomcat 8.5.x → JDK 7+
    注意：Tomcat 10.1+ 使用 Jakarta EE 9/10，包名从 javax.* 迁移为 jakarta.*，不向下兼容。
• 备份关键资产：全量备份 $CATALINA_HOME（含 conf、webapps、lib、work、logs）、数据库、反向代理/负载均衡配置、证书与启动脚本等，便于回滚。
• 在测试环境完成升级演练，覆盖功能、性能与安全策略回归。

标准升级步骤

• 步骤1 停服与备份：优雅停止 Tomcat（避免直接 kill），执行全量备份。
• 步骤2 获取新版本：从 Apache Tomcat 官方下载页获取目标版本（建议校验 SHA-512/PGP）。
• 步骤3 安装新版本：
  • 同系列小版本就地升级（风险最低）：仅替换 $CATALINA_HOME/lib 目录，然后启动验证。
  • 跨大版本或全新安装：解压新版本到新目录，保留旧目录以便回滚。
• 步骤4 迁移配置与数据：将旧版的 conf/（如 server.xml、web.xml、context.xml、tomcat-users.xml）、证书、日志配置等按需拷入新版；保留业务 webapps/（建议先清理 ROOT 与示例应用）。
• 步骤5 调整脚本与环境：更新 CATALINA_HOME/CATALINA_BASE、JAVA_HOME、JAVA_OPTS；如使用 systemd，确保 /etc/systemd/system/tomcat.service 指向新目录。
• 步骤6 启动与验证：启动后访问 http://host:8080，核对 /manager/status 或应用健康检查；抽查关键业务链路与日志。
• 步骤7 回滚预案：若异常，立即切回旧目录或备份，恢复 conf/webapps 并回滚版本。

常见差异与兼容性处理

• 连接器协议差异：从 Tomcat 8 升级到 Tomcat 9 时，HTTP 连接器默认从 Http11Protocol 调整为 Http11NioProtocol，建议在 conf/server.xml 中显式声明：
  • Tomcat 8：

    <Connector port="8090" protocol="org.apache.coyote.http11.Http11Protocol" ... />
    

  • Tomcat 9：

    <Connector port="8090" protocol="org.apache.coyote.http11.Http11NioProtocol" ... />
    

• 命名空间与依赖迁移：Tomcat 10.1+ / Jakarta EE 9+ 将 javax.* 改为 jakarta.*。若应用编译/运行报 ClassNotFoundException: jakarta/servlet/...，需迁移依赖或使用迁移工具（如 tomcat-jakartaee-migration）。
• JDK 不匹配：启动报 “Unsupported major.minor version” 等，说明 JDK 版本不满足 Tomcat 要求，需升级 JDK 或选择兼容的 Tomcat 版本。
• 端口与协议：确认 8080/8443 未被占用，必要时在 server.xml 调整端口；如需 HTTP/2，确保 JDK 8+ 且支持 ALPN。

Linux系统与 systemd 示例流程

• 备份与停服：

  sudo cp -r /opt/tomcat /opt/tomcat_backup_$(date +%F)
  sudo systemctl stop tomcat
  

• 下载与解压（示例为 9.0.x）：

  wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.xx/bin/apache-tomcat-9.0.xx.tar.gz
  sudo tar -xzf apache-tomcat-9.0.xx.tar.gz -C /opt
  sudo ln -sfn /opt/apache-tomcat-9.0.xx /opt/tomcat/latest
  

• 迁移配置与数据：

  sudo cp -r /opt/tomcat_backup_*/conf/* /opt/tomcat/latest/conf/
  sudo cp -r /opt/tomcat_backup_*/webapps/* /opt/tomcat/latest/webapps/
  

• 更新 systemd 服务（如需要）：

  sudo systemctl daemon-reload
  sudo systemctl edit --full tomcat   # 确认 Environment=CATALINA_HOME=/opt/tomcat/latest
  sudo systemctl start tomcat
  sudo systemctl status tomcat
  

• 验证：

  curl -I http://127.0.0.1:8080/
  tail -n 200 /opt/tomcat/latest/logs/catalina.out
  

  如需开放防火墙端口：

  sudo ufw allow 8080/tcp
  sudo ufw allow 443/tcp
  

  以上流程同样适用于 Debian/Ubuntu 等 systemd 发行版。

验证与回滚清单

• 版本与运行环境：

  $CATALINA_HOME/bin/version.sh     # 查看 Tomcat 与 JVM 版本
  ps -ef | grep tomcat
  ss -lntp | grep ':8080\|:8443'
  

• 应用与日志：访问关键业务页面，检查 logs/catalina.out、localhost.log* 是否有异常堆栈、类加载或启动超时。
• 安全与协议：确认 TLS 1.2/1.3 配置、HTTP/2（如启用）可用；如启用 AJP，注意 Tomcat 8.5+ 默认禁用，需显式配置并加固。
• 回滚触发条件：启动失败、关键功能异常、性能显著退化、安全策略不达标。回滚操作：停止新版本、恢复 conf/webapps、切换 符号链接 或还原 $CATALINA_HOME，再启动旧版验证。