Apache Tomcat^®

Apache Tomcat 项目不提供补丁。如果某个 Tomcat 特定版本中宣布了某个功能、错误修复或安全补丁，则您必须升级到该版本。您可能能够从操作系统供应商或其他技术支持机构获得补丁，但 Apache Tomcat 项目不会提供此类补丁。

本文档不涵盖在嵌入式环境中使用 Apache Tomcat 的升级。我们假定如果您在嵌入式环境中使用 Apache Tomcat，那么您拥有执行升级所需的知识，无需像此处提供的入门文档。

您应该阅读与您特定升级页面相关的迁移指南。如果您正在从 Apache Tomcat 9.0 升级到 Apache Tomcat 10.1，您应该阅读“Tomcat 10.1 迁移指南”，其中涵盖了从上一版本升级所需的所有内容。

如果您一次升级多个版本，则应阅读中间的所有迁移指南。例如，如果您正在从 Tomcat 8.5 升级到 Tomcat 10.1，则应阅读“Tomcat 9.0 迁移指南”、“Tomcat 10.0 迁移指南”和“Tomcat 10.1 迁移指南”。

您最可能需要迁移的配置文件是您的 conf/server.xml 文件。

快速确定您的 server.xml 文件可能需要进行哪些更改的一种方法是使用 diff 程序将您现有的旧 Tomcat 版本文件与您的旧 Apache Tomcat 版本附带的原始配置文件进行比较。

例如

$ diff /path/to/stock/tomcat/conf/server.xml /path/to/your/tomcat/conf/server.xml

这将显示对原始文件进行的、您环境特有的更改。您可以将这些更改应用于新 Apache Tomcat 版本的新安装。

您可能希望从以前的安装中复制或调整一些其他配置文件。以下是您可能在旧安装中自定义的那些其他文件的列表。

• conf/web.xml
• conf/context.xml
• conf/tomcat-users.xml
• conf/logging.properties
• bin/setenv.sh (如果存在)
• conf/catalina.properties
• conf/catalina.policy
• conf/jaspic-providers.xml

如果您不确定，可以使用上面显示相同的方法来检查您的安装与原始 Apache Tomcat 配置文件之间的任何差异。

阅读您正在使用的主要版本的迁移指南仍然很重要，特别是其中的“升级”部分。

迁移指南还包含一个“值得注意的更改”部分，其中包括主要版本内的更改——即主要版本修订号中的次要版本——其中包含非常重要的更改。这类更改包括引入新的默认值、新要求（通常出于安全原因），或与先前版本相比的破坏性更改（也通常出于安全原因）。

最后，迁移指南有一个部分允许您比较次要版本之间的原始配置文件，以查看这些版本之间是否进行了任何重要更改。使用起来很简单：只需在迁移指南页面上的下拉框中选择您的旧版本和新版本，然后点击“查看差异”即可。