Debian 上更新 Tomcat 的关键注意事项
一 版本与 Java 兼容
- 明确目标小版本与变更范围：跨小版本（如 9.0.x → 9.0.y）通常平滑；跨大版本（如 9 → 10）属于“迁移”，API 包名从 javax. → jakarta.**，应用需适配后才能上线。
- 核对 Java 版本要求：Tomcat 9 需 JDK 8+，Tomcat 10 需 JDK 11+；同时确认运行环境（JRE/JDK、供应商与版本）满足要求。
- 关注 **End-of-Life（EOL）**与漏洞修复节奏：优先选择仍在维护的 9.x 或 10.x 稳定小版本，避免已知漏洞与缺乏修复的旧版本。
二 升级方式与路径
- 区分两种路径：
- 包管理升级（apt）：适合使用发行版仓库的场景，升级过程由 APT 协调，回滚相对容易；但版本可能滞后于上游。
- 二进制解压升级（官方 tar.gz）：适合需要快速获取上游最新小版本或跨大版本迁移的场景，可控性强，但需自行管理目录、权限与服务单元。
- 采用二进制方式时的要点：
- 使用符号链接（如 /opt/tomcat/latest）指向当前版本目录，升级时仅替换目标目录后更新链接，减少改动面。
- 如采用 systemd，确保服务文件中的 CATALINA_HOME / CATALINA_BASE / JAVA_HOME 等指向新目录，变更后执行 systemctl daemon-reload。
三 变更控制与回滚预案
- 全量备份：在停机窗口前备份 conf/（如 server.xml、context.xml、web.xml、tomcat-users.xml）、webapps/、自定义 lib/、以及必要的 work/ 与 logs/；对生产环境建议保留可快速回滚的 完整目录快照。
- 灰度与回滚：先在 测试/预发 验证；保留上一版目录与符号链接，出现问题时快速切回；必要时用备份还原配置与应用。
- 变更记录：明确并记录本次升级的 目标版本、变更清单、回滚步骤 与 影响评估，便于审计与应急。
四 配置与目录迁移要点
- 配置迁移策略：优先“只迁移必要的 conf 变更”，避免盲目覆盖；保留原有 server.xml 的 与 自定义，先对比差异后合并。
- 目录与权限：
- 保持 webapps/ 中的应用与 work/ 分离，升级时避免覆盖未打包的应用产物；必要时清理过期 work/Catalina/localhost。
- 确认 tomcat 用户/组 对安装目录拥有正确权限（如 chown -R tomcat:tomcat /opt/tomcat）。
- 管理应用与凭据：如启用 manager/ host-manager，需重新在 tomcat-users.xml 配置角色与密码，避免默认弱口令。
- 端口与防火墙：确认 8080/8443 等端口未被占用；如使用 ufw，按需放行（如 ufw allow 8080/tcp）。
五 启动验证与运行期检查
- 启动与日志：启动后优先查看 catalina.out 与 localhost.log*，确认无 ClassNotFound、Listener/Filter 初始化失败、端口冲突 等错误；必要时开启更详细日志。
- 功能与回归：访问 http://:8080 验证欢迎页与已部署应用；对关键业务做 冒烟测试，关注会话保持、数据源连接池、SSL/TLS、反向代理与负载均衡健康探针。
- 监控与告警：观察 JVM 内存/GC、线程数、请求耗时与错误率；升级后短期内加强指标与日志巡检，确保稳定性。
