当从一个主要的 Apache Tomcat® 版本更新到新版本时，请确保您的系统上安装的 JVM 至少支持所需的 Java 版本。虽然旧版本的 Tomcat 可能与较新的 JVM 不兼容，但所有当前支持的 Apache Tomcat 版本（9.0.x、10.1.x 和 11.0.x）已知可在 Java 17 JVM 上正常运行。
当从一个主要的 Tomcat 版本迁移到另一个版本（例如从 Tomcat 9 迁移到 Tomcat 10，或从 Tomcat 10 迁移到 Tomcat 11）时，您不应将旧版本的配置文件复制到新版本。推荐的方法是从新版 Apache Tomcat 的默认配置开始，并根据需要进行调整。
当在同一主要版本内从一个次要版本迁移到另一个次要版本时（例如从 Tomcat 9.0.29 迁移到 Tomcat 9.0.30），您可以保留配置文件，但应检查是否有任何默认设置已更改和/或是否有任何新元素已添加，并相应地调整您的配置文件。
关于在 11.0.x 版本之间升级，请参阅 Tomcat 11.0.x 迁移指南的升级部分。
关于从 10.1.x 迁移到 11.0.x，请参阅Tomcat 11.0.x 迁移指南。
关于在 10.1.x 版本之间升级，请参阅 Tomcat 10.1.x 迁移指南的升级部分。
关于从 10.0.x 迁移到 10.1.x，请参阅Tomcat 10.1.x 迁移指南。
关于在 10.0.x 版本之间升级，请参阅 Tomcat 10.0.x 迁移指南的升级部分。
关于从 9.0.x 迁移到 10.0.x，请参阅Tomcat 10.0.x 迁移指南。
关于在 9.0.x 版本之间升级，请参阅 Tomcat 9.0.x 迁移指南的升级部分。
关于从 8.0.x / 8.5.x 迁移到 9.0.x，请参阅Tomcat 9.0.x 迁移指南。
关于在 8.5.x 版本之间升级，请参阅 Tomcat 8.5.x 迁移指南的升级部分。
关于从 8.0.x 迁移到 8.5.x，请参阅Tomcat 8.5.x 迁移指南。
关于在 8.0.x 版本之间升级，请参阅 Tomcat 8.0.x 迁移指南的升级部分。
关于从 7.0.x 迁移到 8.0.x，请参阅Tomcat 8.0.x 迁移指南。
关于在 7.0.x 版本之间升级，请参阅 Tomcat 7.0.x 迁移指南的升级部分。
关于从 6.0.x 迁移到 7.0.x，请参阅Tomcat 7.0.x 迁移指南。
关于在 6.0.x 版本之间升级，请参阅 Tomcat 6.0.x 迁移指南的升级部分。
关于从 5.5.x 迁移到 6.0.x，请参阅Tomcat 6.0.x 迁移指南。