在将一个主要版本的 Apache Tomcat® 升级到更新版本时，请确保系统上安装的 JVM 至少支持所需的 Java 版本。虽然旧版本的 Tomcat 可能与较新的 JVM 不兼容，但所有当前支持的 Apache Tomcat 版本（8.5.x、9.0.x、10.1.x 和 11.0.x）已知在 Java 17 JVM 上可以正常运行。
在将一个主要版本的 Tomcat 迁移到另一个版本时（例如，从 Tomcat 8 迁移到 Tomcat 9，或从 Tomcat 9 迁移到 Tomcat 10），您不应该将旧版本的配置文件复制到新版本。建议的方法是从新版本的 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 迁移指南。