从 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 迁移指南。