內容

目錄

一般

請先閱讀一般 遷移指南頁面，以了解 Apache Tomcat® 版本之間遷移或升級的常見考量因素。

從 10.1.x 遷移到 11.0.x

此區段列出 10.1.x 和 11.0.x 之間的所有已知變更，這些變更可能會在升級時造成向下相容性的問題。

需要 Java 21

Apache Tomcat 11.0.x 需要 Java 21 或更新版本。Apache Tomcat 10.1.x 需要 Java 11。

SecurityManager 已在 Java 17 起標示為已棄用，且在 Jakarta EE 11 規格專案中已移除在 SecurityManager 下執行的支援。因此，在 Tomcat 11.0.x 中已移除組態 SecurityManager 的支援。

規格 API

Apache Tomcat 11.0 支援 Jakarta Servlet 6.1、Jakarta Server Pages 4.0、Jakarta Expression Language 6.0、JakartaWebSocket 2.2 和 Jakarta Authentication 3.1 規格。

Servlet 6.1 API

無變更。

伺服器頁面 4.0

3.1 API 中標示為已棄用的所有方法和類別都已移除。

表達式語言 6.0

5.0 API 中標示為已棄用的所有方法和類別都已移除。

已移除在 SecurityManager 下執行的支援。

WebSocket 待定

已移除在 SecurityManager 下執行的支援。

驗證待定

已移除在 SecurityManager 下執行的支援。

內部 API

雖然 Tomcat 11.0 內部 API 與 Tomcat 10.1 廣泛相容，但細節層級已進行許多變更，且不相容於二進位。與 Tomcat 內部元件互動的自訂元件開發人員應檢閱相關 API 的 JavaDoc。

特別要注意的是

  • 10.1.x 中標記為已棄用的所有程式碼均已移除。
  • 如果轉換失敗，從位元組轉換為字元的轉換現在會擲回例外狀況。

升級 11.0.x

將 Apache Tomcat 實例從一個 Tomcat 11.0 版本升級到另一個版本時，特別是在為 $CATALINA_HOME 和 $CATALINA_BASE 使用不同的位置時，必須確保升級時已套用組態檔案中的任何變更，例如新的屬性及預設值的變更。為協助識別這些變更，可使用下表單檢視 Tomcat 11.0 不同版本中組態檔案之間的差異。

Tomcat 11.0.x 值得注意的變更

Tomcat 開發人員的目標是讓每個穩定的修補程式版本與前一個版本完全向下相容。偶爾，為了修正錯誤，必須中斷向下相容性。在多數情況下，這些變更不會被注意到。本節列出不完全向下相容的變更，且在升級時可能會導致中斷。

  • 在 11.0.0-M5 之後，Connector 屬性 maxParameterCount 的預設值已從 10,000 減少到 1,000。

Tomcat 11.0.x 組態檔差異

從下列方塊中選取組態檔案、舊版本和新版本，然後按一下「檢視差異」以查看差異。差異將顯示在新分頁/視窗中。

注意：如果沒有差異，您將會看到錯誤頁面。

您也可以在工作副本中使用類似以下的 Git 指令

git diff 11.0.0-M1 11.0.0-M3 -- conf/