快捷導(dǎo)航

一篇文章徹底解決Win10系統(tǒng)下同時(shí)部署多個(gè)版本的Tomcat

更新時(shí)間：2025年08月28日 09:27:20 作者：lingggggaaaa

在Windows系統(tǒng)上部署Tomcat服務(wù)器是一個(gè)相對簡單的過程,這篇文章主要介紹了Win10系統(tǒng)下同時(shí)部署多個(gè)版本Tomcat的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下

前言

最近在學(xué)習(xí)JavaWeb的時(shí)候，想安裝新版本的Tomcat11，又不想把之前安裝過的Tomcat9卸掉，于是就在想能不能同時(shí)安裝兩個(gè)版本的Tomcat兼容一下

所以就有了今天的這篇文章，教會(huì)你們?nèi)绾未罱ǘ鄠€(gè)版本的Tomcat服務(wù)器

演示的環(huán)境是Windows10，安裝的版本為Tomcat11，所用到的Java版本為jdk17

Tomcat下載鏈接：https://tomcat.apache.org/
JDK17下載鏈接：https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html 或者點(diǎn)擊這里下載

注意，這里下載的都是zip壓縮包，不要下載安裝程序！，避免環(huán)境沖突

所用到的文件夾

Tomcat11 文件夾D:\Tomcat11：

Tomcat 的bin目錄：

Tomcat的conf目錄：

Jdk 17目錄D:\JAVA\jdk17：

Tomcat服務(wù)端口修改

由于之前已經(jīng)安裝過了Tomcat9，這里為了避免沖突，需要先將啟動(dòng)和關(guān)閉的端口修改一下
在conf目錄下的server.xml文件中，修改如下代碼：

<!-- 將port 8005修改為8015 -->
<Server port="8015" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />

<!-- 將port 8080修改為8081 -->
<Connector port="8081" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

這里可以修改為任意端口，只要保證不沖突就行，然后保存文件

Tomcat參數(shù)修改

這里Tomcat9和Tomcat11用的jdk版本不同，所以避免沖突，我們需要替換一下環(huán)境變量
打開bin目錄，對所有的.bat文件，替換如下字段，只要與之前的區(qū)別開就行：
1. CATALINA_HOME --> CATALINA11_HOME
2. CATALINA_BASE --> CATALINA11_BASE
3. CATALINA_TIMDIR --> CATALINA11_TIMDIR
4. JRE_HOME --> JRE11_HOME
5. JAVA_HOME --> JAVA11_HOME

環(huán)境變量配置

然后我們Win + R輸入sysdm.cpl配置環(huán)境變量
第一個(gè)地方是系統(tǒng)變量這里，添加如下內(nèi)容（根據(jù)自己的實(shí)際安裝路徑更改）：

CATALINA11_BASE  : D:\Tomcat11
CATALINA11_HOME : D:\Tomcat11
CATALINA11_TIMDIR : D:\Tomcat11\temp
JAVA11_HOME : D:\JAVA\jdk17

然后找到Path，雙擊進(jìn)行編輯，添加JDK的環(huán)境D:\JAVA\jdk17\bin或者%JAVA11_HOME%\bin：
注意，這里盡量設(shè)置在其他Java版本的前面，避免系統(tǒng)解析舊的Java版本

驗(yàn)證環(huán)境是否配置成功

使用java -version命令驗(yàn)證Java環(huán)境是否修改成功：
如果仍然是其他版本的Java版本，可以重新打開一個(gè)終端再嘗試一遍
或者輸入echo %JAVA11_HOME%看一看環(huán)境是否生效
在終端下打開Tomcat文件夾，輸入命令.\catalina.bat run運(yùn)行起來，到這里應(yīng)該是沒有報(bào)錯(cuò)信息的：
如果顯示上面這個(gè)頁面就說明Tomcat啟動(dòng)成功了，我們訪問http://localhost:8081即可：
之后再啟動(dòng)Tomcat就直接雙擊startup.bat文件即可
這里同時(shí)啟動(dòng)兩個(gè)版本的Tomcat都是沒問題的

可能遇到的問題

問題一：startup.bat閃退

如果直接啟動(dòng)startup.bat發(fā)生閃退，可以在命令行中啟動(dòng)看報(bào)錯(cuò)原因，一般都是端口占用、環(huán)境配置錯(cuò)誤或者文件損壞
解決方法：
- netstat -ano | findstr "8080"查看端口（看自己配置文件中的端口）是否被占用，如果被占用，在資源管理器中搜索相應(yīng)的PID，結(jié)束進(jìn)程即可
- 如果是環(huán)境配置錯(cuò)誤，就重新配置環(huán)境
- 文件如果損壞，重新下載復(fù)制損壞文件即可

問題二：startup.bat成功啟動(dòng)，但仍打不開服務(wù)器

如果在命令行中啟動(dòng)startup.bat，這里它會(huì)啟動(dòng)兩個(gè)黑窗口，如果成功啟動(dòng)第一個(gè)，但是第二個(gè)黑窗口閃退，如下：
只能看到這個(gè)頁面的話，說明可能是端口被占用，或者一些配置上的問題，比如系統(tǒng)仍然沒有識別到正確的JDK版本等等
我們可以在命令行中輸入.\catalina.bat run去看一看報(bào)錯(cuò)信息，我這里遇到過兩個(gè)問題：

第一個(gè)問題是：

PS D:\Tomcat11\bin> .\catalina.bat run
Using CATALINA11_BASE:   "D:\Tomcat11"
Using CATALINA11_HOME:   "D:\Tomcat11"
Using CATALINA11_TMPDIR: "D:\Tomcat11\temp"
Using JRE11_HOME:        "D:\JAVA\jdk11"
Using CLASSPATH:       "D:\Tomcat11\bin\bootstrap.jar;D:\Tomcat11\bin\tomcat-juli.jar"
Using CATALINA_OPTS:   ""
Unrecognized option: --enable-native-access=ALL-UNNAMED
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

這個(gè)錯(cuò)誤提示 “Unrecognized option: --enable-native-access=ALL-UNNAMED” 表明 Tomcat 啟動(dòng)時(shí)嘗試使用的 JVM 參數(shù)與你當(dāng)前的 JDK 版本不兼容，這通常是由于 JDK 版本識別錯(cuò)誤導(dǎo)致的。
可以在Tomcat的catalina.bat文件中找到這行命令，然后注釋/刪除掉：

第二個(gè)問題是：

PS D:\Tomcat11\bin> .\catalina.bat run
Using CATALINA11_BASE:   "D:\Tomcat11"
Using CATALINA11_HOME:   "D:\Tomcat11"
Using CATALINA11_TMPDIR: "D:\Tomcat11\temp"
Using JRE11_HOME:        "D:\JAVA\jdk11"
Using CLASSPATH:       "D:\Tomcat11\bin\bootstrap.jar;D:\Tomcat11\bin\tomcat-juli.jar"
Using CATALINA_OPTS:   ""
錯(cuò)誤: 加載主類 org.apache.catalina.startup.Bootstrap 時(shí)出現(xiàn) LinkageError
        java.lang.UnsupportedClassVersionError: org/apache/catalina/startup/Bootstrap has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 55.0