器部署多Tomcat實(shí)例：端口規(guī)劃、服務(wù)化與運(yùn)維指南)
1. 項(xiàng)目概述與核心價(jià)值在中小型企業(yè)的實(shí)際運(yùn)維場(chǎng)景里或者個(gè)人開發(fā)者手頭只有一臺(tái)性能尚可的服務(wù)器時(shí)我們常常會(huì)面臨一個(gè)非常現(xiàn)實(shí)的需求如何在這一臺(tái)物理或云服務(wù)器上同時(shí)運(yùn)行多個(gè)基于Tomcat的Java Web應(yīng)用。這可能是為了隔離不同客戶的項(xiàng)目、區(qū)分測(cè)試與生產(chǎn)環(huán)境或者僅僅是最大化利用服務(wù)器資源。直接在一份Tomcat里部署多個(gè)應(yīng)用雖然可行但在日志管理、應(yīng)用重啟、資源隔離和版本依賴方面會(huì)帶來諸多不便。因此學(xué)會(huì)在一臺(tái)服務(wù)器上部署多個(gè)獨(dú)立的Tomcat實(shí)例每個(gè)實(shí)例承載一個(gè)或多個(gè)項(xiàng)目是一項(xiàng)非常實(shí)用且基礎(chǔ)的服務(wù)器管理技能。這篇文章我將結(jié)合自己多年的部署經(jīng)驗(yàn)為你拆解從零開始在一臺(tái)Linux服務(wù)器以CentOS 7為例上部署多個(gè)Tomcat及項(xiàng)目的完整流程。整個(gè)過程會(huì)涵蓋環(huán)境準(zhǔn)備、Tomcat實(shí)例的獨(dú)立配置、項(xiàng)目部署、服務(wù)化管理以及最重要的——端口沖突的解決與日常運(yùn)維技巧。無論你是剛接觸服務(wù)器部署的開發(fā)者還是需要優(yōu)化現(xiàn)有部署結(jié)構(gòu)的運(yùn)維人員這篇手把手的圖文指南都能提供清晰的路徑。2. 環(huán)境準(zhǔn)備與規(guī)劃在開始動(dòng)手之前清晰的規(guī)劃是避免后續(xù)混亂的關(guān)鍵。我們需要從軟件環(huán)境和部署結(jié)構(gòu)兩方面做好準(zhǔn)備。2.1 基礎(chǔ)軟件環(huán)境檢查與安裝首先確保你的服務(wù)器已經(jīng)具備了運(yùn)行Java Web應(yīng)用的基礎(chǔ)環(huán)境。通過SSH連接到你的服務(wù)器執(zhí)行以下檢查與安裝步驟。Java環(huán)境JDKTomcat運(yùn)行依賴于Java環(huán)境。推薦使用JDK 8或JDK 11這些長(zhǎng)期支持版本。# 檢查是否已安裝Java及其版本 java -version如果未安裝可以使用yum進(jìn)行安裝以O(shè)penJDK 8為例# 搜索可用的JDK包 yum search java-1.8.0-openjdk # 安裝JDK開發(fā)包包含JRE yum install -y java-1.8.0-openjdk-devel安裝后再次驗(yàn)證java -version和javac -version。規(guī)劃安裝目錄為了管理清晰建議為所有Tomcat實(shí)例創(chuàng)建一個(gè)統(tǒng)一的父目錄。例如我習(xí)慣在/opt下創(chuàng)建tomcats目錄。mkdir -p /opt/tomcats cd /opt/tomcats后續(xù)下載的Tomcat壓縮包和解壓后的各個(gè)實(shí)例都將放在這個(gè)目錄下。2.2 部署結(jié)構(gòu)規(guī)劃這是核心步驟。我們需要決定部署多少個(gè)Tomcat實(shí)例以及如何為它們分配唯一的標(biāo)識(shí)和資源。確定實(shí)例數(shù)量與命名假設(shè)我們需要部署兩個(gè)Tomcat實(shí)例分別運(yùn)行“客戶門戶系統(tǒng)”和“內(nèi)部管理系統(tǒng)”。我們可以這樣命名tomcat-portal: 對(duì)應(yīng)客戶門戶。tomcat-internal: 對(duì)應(yīng)內(nèi)部系統(tǒng)。 清晰的命名有助于后續(xù)的腳本編寫和日志查看。端口規(guī)劃表至關(guān)重要單個(gè)Tomcat默認(rèn)使用8080端口HTTP、8005端口SHUTDOWN和8009端口AJP。多實(shí)例必須避免端口沖突。我們需要為每個(gè)實(shí)例規(guī)劃一套唯一的端口。建議制作一個(gè)表格實(shí)例名稱HTTP端口SHUTDOWN端口AJP端口備注tomcat-portal808080058009默認(rèn)實(shí)例可保留tomcat-internal808180068010第二個(gè)實(shí)例全部遞增tomcat-app3808280078011預(yù)留第三個(gè)實(shí)例端口注意在生產(chǎn)環(huán)境中如果服務(wù)器內(nèi)存充足建議為每個(gè)實(shí)例的SHUTDOWN端口也設(shè)置不同的值這是Tomcat官方推薦的做法可以防止誤操作關(guān)閉錯(cuò)誤的實(shí)例。AJP端口通常在使用Apache HTTPD等前端代理時(shí)才需要如果只用Tomcat可以暫時(shí)不修改但為了規(guī)范性建議一并修改。目錄結(jié)構(gòu)預(yù)覽規(guī)劃好后的/opt/tomcats目錄結(jié)構(gòu)將如下所示/opt/tomcats/ ├── apache-tomcat-9.0.xx.tar.gz # 下載的原始?jí)嚎s包 ├── tomcat-portal/ # 實(shí)例一目錄 │ ├── bin/ # 啟動(dòng)腳本等 │ ├── conf/ # 配置文件需修改 │ ├── logs/ # 實(shí)例專屬日志 │ ├── webapps/ # 部署項(xiàng)目war包在此 │ └── ... └── tomcat-internal/ # 實(shí)例二目錄 ├── bin/ ├── conf/ ├── logs/ ├── webapps/ └── ...3. 下載、解壓與多實(shí)例配置有了清晰的規(guī)劃我們就可以開始具體的配置工作了。3.1 下載與解壓Tomcat首先從Apache官網(wǎng)下載Tomcat的二進(jìn)制壓縮包tar.gz格式。以Tomcat 9為例# 進(jìn)入規(guī)劃好的目錄 cd /opt/tomcats # 使用wget下載請(qǐng)?zhí)鎿Q為官網(wǎng)最新的穩(wěn)定版鏈接 wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.xx/bin/apache-tomcat-9.0.xx.tar.gz # 解壓壓縮包 tar -zxvf apache-tomcat-9.0.xx.tar.gz # 解壓后得到目錄 apache-tomcat-9.0.xx3.2 創(chuàng)建第一個(gè)Tomcat實(shí)例tomcat-portal我們將解壓后的目錄復(fù)制一份作為我們的第一個(gè)實(shí)例并以其命名。# 復(fù)制并重命名創(chuàng)建第一個(gè)實(shí)例 cp -r apache-tomcat-9.0.xx tomcat-portal現(xiàn)在進(jìn)入tomcat-portal的配置目錄開始修改端口。cd tomcat-portal/conf # 使用vi或nano編輯 server.xml vi server.xml在server.xml文件中找到以下三個(gè)關(guān)鍵連接器Connector配置HTTP/1.1 Connector(默認(rèn)端口8080):Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /因?yàn)槲覀円?guī)劃tomcat-portal使用默認(rèn)端口所以這里不需要修改。如果你想讓它使用其他端口比如8080被占用可以在這里修改。AJP Connector(默認(rèn)端口8009):Connector port8009 protocolAJP/1.3 redirectPort8443 /同樣按規(guī)劃我們保留8009不需要修改。Server Port(SHUTDOWN端口默認(rèn)8005):Server port8005 shutdownSHUTDOWN這是Tomcat監(jiān)聽關(guān)閉指令的端口。按規(guī)劃保留8005不需要修改。第一個(gè)實(shí)例配置完成。它將繼續(xù)使用Tomcat的默認(rèn)端口組8080, 8005, 8009。3.3 創(chuàng)建并配置第二個(gè)Tomcat實(shí)例tomcat-internal現(xiàn)在創(chuàng)建第二個(gè)實(shí)例并修改其所有端口避免與第一個(gè)實(shí)例沖突。# 回到tomcats根目錄 cd /opt/tomcats # 復(fù)制原始解壓目錄創(chuàng)建第二個(gè)實(shí)例 cp -r apache-tomcat-9.0.xx tomcat-internal # 進(jìn)入其配置目錄 cd tomcat-internal/conf vi server.xml在第二個(gè)實(shí)例的server.xml中根據(jù)我們之前的規(guī)劃表進(jìn)行修改修改HTTP端口為8081:Connector port8081 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /修改AJP端口為8010:Connector port8010 protocolAJP/1.3 redirectPort8443 /修改SHUTDOWN端口為8006:Server port8006 shutdownSHUTDOWN保存并退出編輯器。至此第二個(gè)實(shí)例的端口配置已完成它將在8081端口提供HTTP服務(wù)。3.4 配置技巧與注意事項(xiàng)環(huán)境變量隔離每個(gè)Tomcat實(shí)例的bin/catalina.sh腳本會(huì)讀取CATALINA_HOME和CATALINA_BASE環(huán)境變量。在我們這種復(fù)制目錄的部署方式中每個(gè)實(shí)例的目錄本身就是其CATALINA_BASE而CATALINA_HOME可以指向原始解壓目錄或留空腳本會(huì)自動(dòng)處理。這種結(jié)構(gòu)實(shí)現(xiàn)了天然的隔離。內(nèi)存參數(shù)調(diào)整如果服務(wù)器內(nèi)存有限或者應(yīng)用本身比較吃內(nèi)存需要為每個(gè)Tomcat實(shí)例單獨(dú)設(shè)置JVM內(nèi)存參數(shù)。編輯每個(gè)實(shí)例bin/catalina.sh文件在文件開頭附近注釋之后添加類似如下的設(shè)置# 在 bin/catalina.sh 中添加 export JAVA_OPTS-server -Xms512m -Xmx1024m -XX:MetaspaceSize128m -XX:MaxMetaspaceSize256m這樣可以為該實(shí)例設(shè)定初始堆內(nèi)存512MB最大堆內(nèi)存1024MB。請(qǐng)根據(jù)服務(wù)器總內(nèi)存和應(yīng)用需求合理分配確保所有實(shí)例總和不超過物理內(nèi)存。日志目錄每個(gè)實(shí)例的logs目錄是獨(dú)立的這非常有利于排查問題。你可以通過tail -f tomcat-portal/logs/catalina.out來單獨(dú)跟蹤某個(gè)應(yīng)用的輸出。4. 項(xiàng)目部署與啟動(dòng)測(cè)試配置好Tomcat實(shí)例后下一步就是將我們的Web應(yīng)用通常是WAR包部署進(jìn)去并測(cè)試啟動(dòng)。4.1 部署WAR包假設(shè)我們有兩個(gè)WAR包c(diǎn)ustomer-portal.war和internal-system.war。# 將WAR包分別放入對(duì)應(yīng)實(shí)例的webapps目錄下 # 可以使用SCP等工具從本地上傳這里假設(shè)已上傳到服務(wù)器/tmp目錄 cp /tmp/customer-portal.war /opt/tomcats/tomcat-portal/webapps/ cp /tmp/internal-system.war /opt/tomcats/tomcat-internal/webapps/Tomcat在啟動(dòng)時(shí)會(huì)自動(dòng)解壓webapps目錄下的WAR文件。你也可以將WAR包解壓成一個(gè)目錄再放入這樣可以預(yù)先修改一些配置文件。4.2 啟動(dòng)Tomcat實(shí)例我們進(jìn)入每個(gè)實(shí)例的bin目錄使用腳本來啟動(dòng)。# 啟動(dòng)第一個(gè)實(shí)例 (tomcat-portal) cd /opt/tomcats/tomcat-portal/bin ./startup.sh # 查看啟動(dòng)日志確認(rèn)無報(bào)錯(cuò) tail -f ../logs/catalina.out # 按 CtrlC 退出日志跟蹤 # 啟動(dòng)第二個(gè)實(shí)例 (tomcat-internal) cd /opt/tomcats/tomcat-internal/bin ./startup.sh tail -f ../logs/catalina.out4.3 驗(yàn)證部署結(jié)果啟動(dòng)完成后通過瀏覽器或curl命令訪問服務(wù)驗(yàn)證部署是否成功。# 驗(yàn)證第一個(gè)實(shí)例端口8080 curl http://localhost:8080/customer-portal/ # 或者訪問服務(wù)器IP: http://你的服務(wù)器IP:8080/customer-portal/ # 驗(yàn)證第二個(gè)實(shí)例端口8081 curl http://localhost:8081/internal-system/如果看到應(yīng)用的首頁或者正常的HTTP響應(yīng)而非404錯(cuò)誤說明部署成功。4.4 防火墻配置如果服務(wù)器開啟了防火墻如firewalld需要放行我們使用的端口。# 放行8080和8081端口 firewall-cmd --permanent --add-port8080/tcp firewall-cmd --permanent --add-port8081/tcp # 重載防火墻規(guī)則 firewall-cmd --reload # 查看已放行的端口 firewall-cmd --list-ports5. 將Tomcat配置為系統(tǒng)服務(wù)Systemd使用startup.sh和shutdown.sh手動(dòng)管理在服務(wù)器重啟后不會(huì)自動(dòng)啟動(dòng)也不便于集中管理。最佳實(shí)踐是將每個(gè)Tomcat實(shí)例配置為獨(dú)立的系統(tǒng)服務(wù)Systemd Service。5.1 為每個(gè)實(shí)例創(chuàng)建Service文件為tomcat-portal創(chuàng)建服務(wù)文件vi /etc/systemd/system/tomcat-portal.service將以下內(nèi)容粘貼進(jìn)去請(qǐng)務(wù)必根據(jù)你的實(shí)際路徑修改CATALINA_HOME和JAVA_HOME[Unit] DescriptionApache Tomcat 9 Instance - Portal Aftersyslog.target network.target [Service] Typeforking # 設(shè)置環(huán)境變量JAVA_HOME指向你的JDK安裝目錄 EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk # CATALINA_HOME 可以指向原始Tomcat目錄也可以指向?qū)嵗夸洝＿@里指向?qū)嵗夸洝?EnvironmentCATALINA_HOME/opt/tomcats/tomcat-portal EnvironmentCATALINA_BASE/opt/tomcats/tomcat-portal EnvironmentCATALINA_PID${CATALINA_BASE}/temp/tomcat.pid # 可以在這里設(shè)置JVM參數(shù)覆蓋catalina.sh中的設(shè)置 EnvironmentJAVA_OPTS-server -Xms512m -Xmx1024m -Djava.awt.headlesstrue # 啟動(dòng)命令 ExecStart${CATALINA_HOME}/bin/startup.sh # 停止命令 ExecStop${CATALINA_HOME}/bin/shutdown.sh Userroot Grouproot UMask0007 RestartSec10 Restartalways [Install] WantedBymulti-user.target同理為tomcat-internal創(chuàng)建服務(wù)文件/etc/systemd/system/tomcat-internal.service內(nèi)容基本相同只需修改Description、CATALINA_HOME、CATALINA_BASE以及JAVA_OPTS如果需要不同的內(nèi)存配置。5.2 啟用并管理服務(wù)創(chuàng)建好服務(wù)文件后重新加載systemd配置然后啟用并啟動(dòng)服務(wù)。# 重新加載systemd配置 systemctl daemon-reload # 啟用tomcat-portal服務(wù)開機(jī)自啟 systemctl enable tomcat-portal.service # 啟動(dòng)tomcat-portal服務(wù) systemctl start tomcat-portal.service # 查看服務(wù)狀態(tài) systemctl status tomcat-portal.service # 對(duì)tomcat-internal執(zhí)行同樣操作 systemctl enable tomcat-internal.service systemctl start tomcat-internal.service systemctl status tomcat-internal.service現(xiàn)在你可以使用標(biāo)準(zhǔn)的systemctl命令來管理你的Tomcat實(shí)例了systemctl start|stop|restart|status tomcat-portaljournalctl -u tomcat-portal -f# 查看該服務(wù)的實(shí)時(shí)日志6. 高級(jí)配置、優(yōu)化與日常運(yùn)維部署完成并能正常運(yùn)行只是第一步要讓多實(shí)例環(huán)境穩(wěn)定、高效還需要一些進(jìn)階配置和運(yùn)維技巧。6.1 會(huì)話共享與負(fù)載均衡考慮雖然本文重點(diǎn)是多實(shí)例部署在同一服務(wù)器但了解其擴(kuò)展方向很重要。如果未來流量增長(zhǎng)需要橫向擴(kuò)展這兩個(gè)實(shí)例可以很容易地加入到負(fù)載均衡器如Nginx后面。在Nginx中可以這樣配置 upstreamhttp { upstream backend_servers { # 指向同一臺(tái)機(jī)器的不同端口 server 127.0.0.1:8080 weight1; server 127.0.0.1:8081 weight1; # 如果未來加了新服務(wù)器直接添加即可 # server 192.168.1.102:8080 weight1; } server { listen 80; server_name yourdomain.com; location / { proxy_pass http://backend_servers; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } }注意如果應(yīng)用使用了Session默認(rèn)情況下Session存儲(chǔ)在各自Tomcat的內(nèi)存中在負(fù)載均衡時(shí)會(huì)導(dǎo)致用戶會(huì)話丟失。此時(shí)需要配置Session共享常見方案有Session粘滯Sticky Session在負(fù)載均衡器設(shè)置讓同一用戶的請(qǐng)求始終轉(zhuǎn)發(fā)到同一臺(tái)Tomcat。Session復(fù)制在Tomcat的server.xml中配置Cluster讓多個(gè)Tomcat實(shí)例間同步Session數(shù)據(jù)對(duì)網(wǎng)絡(luò)和性能有影響。外部Session存儲(chǔ)將Session存入Redis或數(shù)據(jù)庫(kù)等外部存儲(chǔ)這是最推薦的方式徹底解耦。Spring Boot項(xiàng)目可以輕松集成Spring Session來實(shí)現(xiàn)。6.2 日志管理與切割Tomcat默認(rèn)的日志不會(huì)自動(dòng)切割長(zhǎng)期運(yùn)行會(huì)導(dǎo)致catalina.out文件巨大。我們可以使用Linux自帶的logrotate工具來管理。創(chuàng)建日志切割配置文件vi /etc/logrotate.d/tomcat-portal內(nèi)容如下/opt/tomcats/tomcat-portal/logs/catalina.out { copytruncate daily rotate 30 compress missingok dateext size 100M create 644 root root }同樣為tomcat-internal創(chuàng)建一份。這樣配置后日志會(huì)按天或大小100MB進(jìn)行切割保留30份舊的會(huì)被壓縮。6.3 性能監(jiān)控與JVM調(diào)優(yōu)對(duì)于生產(chǎn)環(huán)境監(jiān)控是必不可少的。啟用JMX遠(yuǎn)程監(jiān)控在某個(gè)實(shí)例的bin/catalina.sh的JAVA_OPTS中添加JMX參數(shù)即可使用JConsole或VisualVM進(jìn)行遠(yuǎn)程監(jiān)控。export JAVA_OPTS$JAVA_OPTS -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port9090 \ -Dcom.sun.management.jmxremote.sslfalse \ -Dcom.sun.management.jmxremote.authenticatefalse \ -Djava.rmi.server.hostname你的服務(wù)器IP安全警告上述配置關(guān)閉了SSL和認(rèn)證僅適用于內(nèi)網(wǎng)測(cè)試環(huán)境。生產(chǎn)環(huán)境務(wù)必啟用SSL和強(qiáng)密碼認(rèn)證。GC日志分析在JAVA_OPTS中添加GC日志參數(shù)有助于分析內(nèi)存使用情況和垃圾回收問題。export JAVA_OPTS$JAVA_OPTS -XX:PrintGCDetails -XX:PrintGCDateStamps -XX:PrintGCTimeStamps -Xloggc:../logs/gc.log6.4 自動(dòng)化部署腳本對(duì)于頻繁更新的項(xiàng)目可以編寫簡(jiǎn)單的Shell腳本實(shí)現(xiàn)一鍵停止、備份、部署、啟動(dòng)。創(chuàng)建一個(gè)deploy-portal.sh腳本#!/bin/bash TOMCAT_HOME/opt/tomcats/tomcat-portal WAR_SOURCE/data/new-releases/customer-portal.war BACKUP_DIR/data/backups/$(date %Y%m%d_%H%M%S) echo “停止Tomcat服務(wù)...” systemctl stop tomcat-portal echo “備份舊應(yīng)用...” mkdir -p $BACKUP_DIR cp -r $TOMCAT_HOME/webapps/customer-portal* $BACKUP_DIR/ 2/dev/null || true echo “清理工作目錄...” rm -rf $TOMCAT_HOME/webapps/customer-portal* rm -rf $TOMCAT_HOME/work/Catalina/localhost/customer-portal echo “部署新WAR包...” cp $WAR_SOURCE $TOMCAT_HOME/webapps/ echo “啟動(dòng)Tomcat服務(wù)...” systemctl start tomcat-portal echo “等待應(yīng)用啟動(dòng)...” sleep 30 # 可以添加一個(gè)健康檢查例如curl應(yīng)用的健康端點(diǎn) if curl -s --max-time 10 http://localhost:8080/customer-portal/health /dev/null; then echo “部署成功” else echo “部署可能存在問題請(qǐng)檢查日志$TOMCAT_HOME/logs/catalina.out” fi記得給腳本執(zhí)行權(quán)限chmod x deploy-portal.sh。7. 常見問題排查與解決方案實(shí)錄在實(shí)際操作中你幾乎一定會(huì)遇到一些問題。這里記錄了幾個(gè)最常見的問題和我的排查思路。7.1 端口沖突問題問題現(xiàn)象啟動(dòng)第二個(gè)Tomcat實(shí)例時(shí)失敗日志中報(bào)java.net.BindException: Address already in use。排查步驟確認(rèn)錯(cuò)誤端口查看日志明確是哪個(gè)端口被占用例如8081、8006。查找占用進(jìn)程使用netstat或lsof命令。# 查看8081端口被誰占用 netstat -tlnp | grep :8081 # 或 lsof -i :8081分析原因被其他服務(wù)占用可能是其他軟件如Nginx、另一個(gè)Tomcat占用了該端口。如果是修改沖突方的端口或停止該服務(wù)。被自己的僵尸進(jìn)程占用有時(shí)Tomcat非正常關(guān)閉進(jìn)程未完全退出。使用ps -ef | grep tomcat找到殘留進(jìn)程用kill -9 PID強(qiáng)制結(jié)束。配置未生效確認(rèn)修改的是正確的server.xml文件并且重啟了Tomcat。7.2 應(yīng)用啟動(dòng)失敗但Tomcat本身正常問題現(xiàn)象訪問應(yīng)用URL返回404或500錯(cuò)誤但Tomcat默認(rèn)首頁http://ip:port可以訪問。排查步驟檢查部署位置確認(rèn)WAR包或應(yīng)用目錄是否在正確的webapps目錄下。查看應(yīng)用專屬日志Tomcat會(huì)在logs目錄下為每個(gè)應(yīng)用生成一個(gè)日志文件如localhost_customer-portal_yyyy-MM-dd.log。這里是應(yīng)用初始化失敗信息的第一現(xiàn)場(chǎng)。查看Catalina日志重點(diǎn)查看catalina.out和localhost.log尋找SEVERE或ERROR級(jí)別的日志通常會(huì)有詳細(xì)的堆棧跟蹤。常見原因數(shù)據(jù)庫(kù)連接失敗檢查應(yīng)用配置的數(shù)據(jù)庫(kù)IP、端口、用戶名密碼。依賴缺失檢查WEB-INF/lib下是否有所有必需的JAR包。對(duì)于Spring Boot項(xiàng)目通常一個(gè)可執(zhí)行JAR或WAR包已包含所有依賴。內(nèi)存不足檢查catalina.out是否有OutOfMemoryError。需要調(diào)整JAVA_OPTS中的-Xmx參數(shù)。文件權(quán)限問題確保Tomcat進(jìn)程用戶如root或tomcat用戶對(duì)應(yīng)用目錄、臨時(shí)目錄有讀寫權(quán)限。7.3 服務(wù)無法開機(jī)自啟問題現(xiàn)象配置了systemd服務(wù)并enable了但服務(wù)器重啟后Tomcat沒有啟動(dòng)。排查步驟檢查服務(wù)狀態(tài)systemctl status tomcat-portal看是否顯示active (running)。查看服務(wù)日志journalctl -u tomcat-portal -xe這里會(huì)有詳細(xì)的啟動(dòng)失敗信息。常見原因依賴服務(wù)未就緒在tomcat-portal.service的[Unit]部分可以增加對(duì)網(wǎng)絡(luò)或數(shù)據(jù)庫(kù)的依賴?yán)鏏fternetwork.target mysqld.service。環(huán)境變量問題systemd服務(wù)文件中的JAVA_HOME路徑可能不正確。使用which java和readlink -f $(which java)找到準(zhǔn)確的JAVA_HOME路徑。啟動(dòng)超時(shí)如果應(yīng)用啟動(dòng)非常慢可能超過systemd默認(rèn)的超時(shí)時(shí)間默認(rèn)90秒?？梢栽赱Service]部分增加TimeoutStartSec300來延長(zhǎng)等待時(shí)間。7.4 如何優(yōu)雅地更新應(yīng)用直接替換WAR包Tomcat會(huì)嘗試熱部署但在復(fù)雜應(yīng)用中容易出錯(cuò)。我推薦的流程是通過systemctl停止服務(wù)systemctl stop tomcat-portal。備份舊應(yīng)用和日志可選但建議。刪除webapps下的舊應(yīng)用目錄和WAR包同時(shí)刪除work/Catalina/localhost下對(duì)應(yīng)的緩存目錄。放入新的WAR包。通過systemctl啟動(dòng)服務(wù)systemctl start tomcat-portal。通過tail -f監(jiān)控日志直到看到應(yīng)用啟動(dòng)成功的標(biāo)志。這種“停止-清理-部署-啟動(dòng)”的模式比熱部署更穩(wěn)定對(duì)于絕大多數(shù)應(yīng)用來說幾十秒的停機(jī)時(shí)間是可以接受的。如果要求零停機(jī)則需要設(shè)計(jì)藍(lán)綠部署或滾動(dòng)更新方案這通常需要結(jié)合負(fù)載均衡器和更復(fù)雜的腳本。 Linux服務(wù)器部署多Tomcat實(shí)例：端口規(guī)劃、服務(wù)化與運(yùn)維指南
1. 項(xiàng)目概述與核心價(jià)值在中小型企業(yè)的實(shí)際運(yùn)維場(chǎng)景里或者個(gè)人開發(fā)者手頭只有一臺(tái)性能尚可的服務(wù)器時(shí)我們常常會(huì)面臨一個(gè)非常現(xiàn)實(shí)的需求如何在這一臺(tái)物理或云服務(wù)器上同時(shí)運(yùn)行多個(gè)基于Tomcat的Java Web應(yīng)用。這可能是為了隔離不同客戶的項(xiàng)目、區(qū)分測(cè)試與生產(chǎn)環(huán)境或者僅僅是最大化利用服務(wù)器資源。直接在一份Tomcat里部署多個(gè)應(yīng)用雖然可行但在日志管理、應(yīng)用重啟、資源隔離和版本依賴方面會(huì)帶來諸多不便。因此學(xué)會(huì)在一臺(tái)服務(wù)器上部署多個(gè)獨(dú)立的Tomcat實(shí)例每個(gè)實(shí)例承載一個(gè)或多個(gè)項(xiàng)目是一項(xiàng)非常實(shí)用且基礎(chǔ)的服務(wù)器管理技能。這篇文章我將結(jié)合自己多年的部署經(jīng)驗(yàn)為你拆解從零開始在一臺(tái)Linux服務(wù)器以CentOS 7為例上部署多個(gè)Tomcat及項(xiàng)目的完整流程。整個(gè)過程會(huì)涵蓋環(huán)境準(zhǔn)備、Tomcat實(shí)例的獨(dú)立配置、項(xiàng)目部署、服務(wù)化管理以及最重要的——端口沖突的解決與日常運(yùn)維技巧。無論你是剛接觸服務(wù)器部署的開發(fā)者還是需要優(yōu)化現(xiàn)有部署結(jié)構(gòu)的運(yùn)維人員這篇手把手的圖文指南都能提供清晰的路徑。2. 環(huán)境準(zhǔn)備與規(guī)劃在開始動(dòng)手之前清晰的規(guī)劃是避免后續(xù)混亂的關(guān)鍵。我們需要從軟件環(huán)境和部署結(jié)構(gòu)兩方面做好準(zhǔn)備。2.1 基礎(chǔ)軟件環(huán)境檢查與安裝首先確保你的服務(wù)器已經(jīng)具備了運(yùn)行Java Web應(yīng)用的基礎(chǔ)環(huán)境。通過SSH連接到你的服務(wù)器執(zhí)行以下檢查與安裝步驟。Java環(huán)境JDKTomcat運(yùn)行依賴于Java環(huán)境。推薦使用JDK 8或JDK 11這些長(zhǎng)期支持版本。# 檢查是否已安裝Java及其版本 java -version如果未安裝可以使用yum進(jìn)行安裝以O(shè)penJDK 8為例# 搜索可用的JDK包 yum search java-1.8.0-openjdk # 安裝JDK開發(fā)包包含JRE yum install -y java-1.8.0-openjdk-devel安裝后再次驗(yàn)證java -version和javac -version。規(guī)劃安裝目錄為了管理清晰建議為所有Tomcat實(shí)例創(chuàng)建一個(gè)統(tǒng)一的父目錄。例如我習(xí)慣在/opt下創(chuàng)建tomcats目錄。mkdir -p /opt/tomcats cd /opt/tomcats后續(xù)下載的Tomcat壓縮包和解壓后的各個(gè)實(shí)例都將放在這個(gè)目錄下。2.2 部署結(jié)構(gòu)規(guī)劃這是核心步驟。我們需要決定部署多少個(gè)Tomcat實(shí)例以及如何為它們分配唯一的標(biāo)識(shí)和資源。確定實(shí)例數(shù)量與命名假設(shè)我們需要部署兩個(gè)Tomcat實(shí)例分別運(yùn)行“客戶門戶系統(tǒng)”和“內(nèi)部管理系統(tǒng)”。我們可以這樣命名tomcat-portal: 對(duì)應(yīng)客戶門戶。tomcat-internal: 對(duì)應(yīng)內(nèi)部系統(tǒng)。 清晰的命名有助于后續(xù)的腳本編寫和日志查看。端口規(guī)劃表至關(guān)重要單個(gè)Tomcat默認(rèn)使用8080端口HTTP、8005端口SHUTDOWN和8009端口AJP。多實(shí)例必須避免端口沖突。我們需要為每個(gè)實(shí)例規(guī)劃一套唯一的端口。建議制作一個(gè)表格實(shí)例名稱HTTP端口SHUTDOWN端口AJP端口備注tomcat-portal808080058009默認(rèn)實(shí)例可保留tomcat-internal808180068010第二個(gè)實(shí)例全部遞增tomcat-app3808280078011預(yù)留第三個(gè)實(shí)例端口注意在生產(chǎn)環(huán)境中如果服務(wù)器內(nèi)存充足建議為每個(gè)實(shí)例的SHUTDOWN端口也設(shè)置不同的值這是Tomcat官方推薦的做法可以防止誤操作關(guān)閉錯(cuò)誤的實(shí)例。AJP端口通常在使用Apache HTTPD等前端代理時(shí)才需要如果只用Tomcat可以暫時(shí)不修改但為了規(guī)范性建議一并修改。目錄結(jié)構(gòu)預(yù)覽規(guī)劃好后的/opt/tomcats目錄結(jié)構(gòu)將如下所示/opt/tomcats/ ├── apache-tomcat-9.0.xx.tar.gz # 下載的原始?jí)嚎s包 ├── tomcat-portal/ # 實(shí)例一目錄 │ ├── bin/ # 啟動(dòng)腳本等 │ ├── conf/ # 配置文件需修改 │ ├── logs/ # 實(shí)例專屬日志 │ ├── webapps/ # 部署項(xiàng)目war包在此 │ └── ... └── tomcat-internal/ # 實(shí)例二目錄 ├── bin/ ├── conf/ ├── logs/ ├── webapps/ └── ...3. 下載、解壓與多實(shí)例配置有了清晰的規(guī)劃我們就可以開始具體的配置工作了。3.1 下載與解壓Tomcat首先從Apache官網(wǎng)下載Tomcat的二進(jìn)制壓縮包tar.gz格式。以Tomcat 9為例# 進(jìn)入規(guī)劃好的目錄 cd /opt/tomcats # 使用wget下載請(qǐng)?zhí)鎿Q為官網(wǎng)最新的穩(wěn)定版鏈接 wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.xx/bin/apache-tomcat-9.0.xx.tar.gz # 解壓壓縮包 tar -zxvf apache-tomcat-9.0.xx.tar.gz # 解壓后得到目錄 apache-tomcat-9.0.xx3.2 創(chuàng)建第一個(gè)Tomcat實(shí)例tomcat-portal我們將解壓后的目錄復(fù)制一份作為我們的第一個(gè)實(shí)例并以其命名。# 復(fù)制并重命名創(chuàng)建第一個(gè)實(shí)例 cp -r apache-tomcat-9.0.xx tomcat-portal現(xiàn)在進(jìn)入tomcat-portal的配置目錄開始修改端口。cd tomcat-portal/conf # 使用vi或nano編輯 server.xml vi server.xml在server.xml文件中找到以下三個(gè)關(guān)鍵連接器Connector配置HTTP/1.1 Connector(默認(rèn)端口8080):Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /因?yàn)槲覀円?guī)劃tomcat-portal使用默認(rèn)端口所以這里不需要修改。如果你想讓它使用其他端口比如8080被占用可以在這里修改。AJP Connector(默認(rèn)端口8009):Connector port8009 protocolAJP/1.3 redirectPort8443 /同樣按規(guī)劃我們保留8009不需要修改。Server Port(SHUTDOWN端口默認(rèn)8005):Server port8005 shutdownSHUTDOWN這是Tomcat監(jiān)聽關(guān)閉指令的端口。按規(guī)劃保留8005不需要修改。第一個(gè)實(shí)例配置完成。它將繼續(xù)使用Tomcat的默認(rèn)端口組8080, 8005, 8009。3.3 創(chuàng)建并配置第二個(gè)Tomcat實(shí)例tomcat-internal現(xiàn)在創(chuàng)建第二個(gè)實(shí)例并修改其所有端口避免與第一個(gè)實(shí)例沖突。# 回到tomcats根目錄 cd /opt/tomcats # 復(fù)制原始解壓目錄創(chuàng)建第二個(gè)實(shí)例 cp -r apache-tomcat-9.0.xx tomcat-internal # 進(jìn)入其配置目錄 cd tomcat-internal/conf vi server.xml在第二個(gè)實(shí)例的server.xml中根據(jù)我們之前的規(guī)劃表進(jìn)行修改修改HTTP端口為8081:Connector port8081 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /修改AJP端口為8010:Connector port8010 protocolAJP/1.3 redirectPort8443 /修改SHUTDOWN端口為8006:Server port8006 shutdownSHUTDOWN保存并退出編輯器。至此第二個(gè)實(shí)例的端口配置已完成它將在8081端口提供HTTP服務(wù)。3.4 配置技巧與注意事項(xiàng)環(huán)境變量隔離每個(gè)Tomcat實(shí)例的bin/catalina.sh腳本會(huì)讀取CATALINA_HOME和CATALINA_BASE環(huán)境變量。在我們這種復(fù)制目錄的部署方式中每個(gè)實(shí)例的目錄本身就是其CATALINA_BASE而CATALINA_HOME可以指向原始解壓目錄或留空腳本會(huì)自動(dòng)處理。這種結(jié)構(gòu)實(shí)現(xiàn)了天然的隔離。內(nèi)存參數(shù)調(diào)整如果服務(wù)器內(nèi)存有限或者應(yīng)用本身比較吃內(nèi)存需要為每個(gè)Tomcat實(shí)例單獨(dú)設(shè)置JVM內(nèi)存參數(shù)。編輯每個(gè)實(shí)例bin/catalina.sh文件在文件開頭附近注釋之后添加類似如下的設(shè)置# 在 bin/catalina.sh 中添加 export JAVA_OPTS-server -Xms512m -Xmx1024m -XX:MetaspaceSize128m -XX:MaxMetaspaceSize256m這樣可以為該實(shí)例設(shè)定初始堆內(nèi)存512MB最大堆內(nèi)存1024MB。請(qǐng)根據(jù)服務(wù)器總內(nèi)存和應(yīng)用需求合理分配確保所有實(shí)例總和不超過物理內(nèi)存。日志目錄每個(gè)實(shí)例的logs目錄是獨(dú)立的這非常有利于排查問題。你可以通過tail -f tomcat-portal/logs/catalina.out來單獨(dú)跟蹤某個(gè)應(yīng)用的輸出。4. 項(xiàng)目部署與啟動(dòng)測(cè)試配置好Tomcat實(shí)例后下一步就是將我們的Web應(yīng)用通常是WAR包部署進(jìn)去并測(cè)試啟動(dòng)。4.1 部署WAR包假設(shè)我們有兩個(gè)WAR包c(diǎn)ustomer-portal.war和internal-system.war。# 將WAR包分別放入對(duì)應(yīng)實(shí)例的webapps目錄下 # 可以使用SCP等工具從本地上傳這里假設(shè)已上傳到服務(wù)器/tmp目錄 cp /tmp/customer-portal.war /opt/tomcats/tomcat-portal/webapps/ cp /tmp/internal-system.war /opt/tomcats/tomcat-internal/webapps/Tomcat在啟動(dòng)時(shí)會(huì)自動(dòng)解壓webapps目錄下的WAR文件。你也可以將WAR包解壓成一個(gè)目錄再放入這樣可以預(yù)先修改一些配置文件。4.2 啟動(dòng)Tomcat實(shí)例我們進(jìn)入每個(gè)實(shí)例的bin目錄使用腳本來啟動(dòng)。# 啟動(dòng)第一個(gè)實(shí)例 (tomcat-portal) cd /opt/tomcats/tomcat-portal/bin ./startup.sh # 查看啟動(dòng)日志確認(rèn)無報(bào)錯(cuò) tail -f ../logs/catalina.out # 按 CtrlC 退出日志跟蹤 # 啟動(dòng)第二個(gè)實(shí)例 (tomcat-internal) cd /opt/tomcats/tomcat-internal/bin ./startup.sh tail -f ../logs/catalina.out4.3 驗(yàn)證部署結(jié)果啟動(dòng)完成后通過瀏覽器或curl命令訪問服務(wù)驗(yàn)證部署是否成功。# 驗(yàn)證第一個(gè)實(shí)例端口8080 curl http://localhost:8080/customer-portal/ # 或者訪問服務(wù)器IP: http://你的服務(wù)器IP:8080/customer-portal/ # 驗(yàn)證第二個(gè)實(shí)例端口8081 curl http://localhost:8081/internal-system/如果看到應(yīng)用的首頁或者正常的HTTP響應(yīng)而非404錯(cuò)誤說明部署成功。4.4 防火墻配置如果服務(wù)器開啟了防火墻如firewalld需要放行我們使用的端口。# 放行8080和8081端口 firewall-cmd --permanent --add-port8080/tcp firewall-cmd --permanent --add-port8081/tcp # 重載防火墻規(guī)則 firewall-cmd --reload # 查看已放行的端口 firewall-cmd --list-ports5. 將Tomcat配置為系統(tǒng)服務(wù)Systemd使用startup.sh和shutdown.sh手動(dòng)管理在服務(wù)器重啟后不會(huì)自動(dòng)啟動(dòng)也不便于集中管理。最佳實(shí)踐是將每個(gè)Tomcat實(shí)例配置為獨(dú)立的系統(tǒng)服務(wù)Systemd Service。5.1 為每個(gè)實(shí)例創(chuàng)建Service文件為tomcat-portal創(chuàng)建服務(wù)文件vi /etc/systemd/system/tomcat-portal.service將以下內(nèi)容粘貼進(jìn)去請(qǐng)務(wù)必根據(jù)你的實(shí)際路徑修改CATALINA_HOME和JAVA_HOME[Unit] DescriptionApache Tomcat 9 Instance - Portal Aftersyslog.target network.target [Service] Typeforking # 設(shè)置環(huán)境變量JAVA_HOME指向你的JDK安裝目錄 EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk # CATALINA_HOME 可以指向原始Tomcat目錄也可以指向?qū)嵗夸洝＿@里指向?qū)嵗夸洝?EnvironmentCATALINA_HOME/opt/tomcats/tomcat-portal EnvironmentCATALINA_BASE/opt/tomcats/tomcat-portal EnvironmentCATALINA_PID${CATALINA_BASE}/temp/tomcat.pid # 可以在這里設(shè)置JVM參數(shù)覆蓋catalina.sh中的設(shè)置 EnvironmentJAVA_OPTS-server -Xms512m -Xmx1024m -Djava.awt.headlesstrue # 啟動(dòng)命令 ExecStart${CATALINA_HOME}/bin/startup.sh # 停止命令 ExecStop${CATALINA_HOME}/bin/shutdown.sh Userroot Grouproot UMask0007 RestartSec10 Restartalways [Install] WantedBymulti-user.target同理為tomcat-internal創(chuàng)建服務(wù)文件/etc/systemd/system/tomcat-internal.service內(nèi)容基本相同只需修改Description、CATALINA_HOME、CATALINA_BASE以及JAVA_OPTS如果需要不同的內(nèi)存配置。5.2 啟用并管理服務(wù)創(chuàng)建好服務(wù)文件后重新加載systemd配置然后啟用并啟動(dòng)服務(wù)。# 重新加載systemd配置 systemctl daemon-reload # 啟用tomcat-portal服務(wù)開機(jī)自啟 systemctl enable tomcat-portal.service # 啟動(dòng)tomcat-portal服務(wù) systemctl start tomcat-portal.service # 查看服務(wù)狀態(tài) systemctl status tomcat-portal.service # 對(duì)tomcat-internal執(zhí)行同樣操作 systemctl enable tomcat-internal.service systemctl start tomcat-internal.service systemctl status tomcat-internal.service現(xiàn)在你可以使用標(biāo)準(zhǔn)的systemctl命令來管理你的Tomcat實(shí)例了systemctl start|stop|restart|status tomcat-portaljournalctl -u tomcat-portal -f# 查看該服務(wù)的實(shí)時(shí)日志6. 高級(jí)配置、優(yōu)化與日常運(yùn)維部署完成并能正常運(yùn)行只是第一步要讓多實(shí)例環(huán)境穩(wěn)定、高效還需要一些進(jìn)階配置和運(yùn)維技巧。6.1 會(huì)話共享與負(fù)載均衡考慮雖然本文重點(diǎn)是多實(shí)例部署在同一服務(wù)器但了解其擴(kuò)展方向很重要。如果未來流量增長(zhǎng)需要橫向擴(kuò)展這兩個(gè)實(shí)例可以很容易地加入到負(fù)載均衡器如Nginx后面。在Nginx中可以這樣配置 upstreamhttp { upstream backend_servers { # 指向同一臺(tái)機(jī)器的不同端口 server 127.0.0.1:8080 weight1; server 127.0.0.1:8081 weight1; # 如果未來加了新服務(wù)器直接添加即可 # server 192.168.1.102:8080 weight1; } server { listen 80; server_name yourdomain.com; location / { proxy_pass http://backend_servers; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } }注意如果應(yīng)用使用了Session默認(rèn)情況下Session存儲(chǔ)在各自Tomcat的內(nèi)存中在負(fù)載均衡時(shí)會(huì)導(dǎo)致用戶會(huì)話丟失。此時(shí)需要配置Session共享常見方案有Session粘滯Sticky Session在負(fù)載均衡器設(shè)置讓同一用戶的請(qǐng)求始終轉(zhuǎn)發(fā)到同一臺(tái)Tomcat。Session復(fù)制在Tomcat的server.xml中配置Cluster讓多個(gè)Tomcat實(shí)例間同步Session數(shù)據(jù)對(duì)網(wǎng)絡(luò)和性能有影響。外部Session存儲(chǔ)將Session存入Redis或數(shù)據(jù)庫(kù)等外部存儲(chǔ)這是最推薦的方式徹底解耦。Spring Boot項(xiàng)目可以輕松集成Spring Session來實(shí)現(xiàn)。6.2 日志管理與切割Tomcat默認(rèn)的日志不會(huì)自動(dòng)切割長(zhǎng)期運(yùn)行會(huì)導(dǎo)致catalina.out文件巨大。我們可以使用Linux自帶的logrotate工具來管理。創(chuàng)建日志切割配置文件vi /etc/logrotate.d/tomcat-portal內(nèi)容如下/opt/tomcats/tomcat-portal/logs/catalina.out { copytruncate daily rotate 30 compress missingok dateext size 100M create 644 root root }同樣為tomcat-internal創(chuàng)建一份。這樣配置后日志會(huì)按天或大小100MB進(jìn)行切割保留30份舊的會(huì)被壓縮。6.3 性能監(jiān)控與JVM調(diào)優(yōu)對(duì)于生產(chǎn)環(huán)境監(jiān)控是必不可少的。啟用JMX遠(yuǎn)程監(jiān)控在某個(gè)實(shí)例的bin/catalina.sh的JAVA_OPTS中添加JMX參數(shù)即可使用JConsole或VisualVM進(jìn)行遠(yuǎn)程監(jiān)控。export JAVA_OPTS$JAVA_OPTS -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port9090 \ -Dcom.sun.management.jmxremote.sslfalse \ -Dcom.sun.management.jmxremote.authenticatefalse \ -Djava.rmi.server.hostname你的服務(wù)器IP安全警告上述配置關(guān)閉了SSL和認(rèn)證僅適用于內(nèi)網(wǎng)測(cè)試環(huán)境。生產(chǎn)環(huán)境務(wù)必啟用SSL和強(qiáng)密碼認(rèn)證。GC日志分析在JAVA_OPTS中添加GC日志參數(shù)有助于分析內(nèi)存使用情況和垃圾回收問題。export JAVA_OPTS$JAVA_OPTS -XX:PrintGCDetails -XX:PrintGCDateStamps -XX:PrintGCTimeStamps -Xloggc:../logs/gc.log6.4 自動(dòng)化部署腳本對(duì)于頻繁更新的項(xiàng)目可以編寫簡(jiǎn)單的Shell腳本實(shí)現(xiàn)一鍵停止、備份、部署、啟動(dòng)。創(chuàng)建一個(gè)deploy-portal.sh腳本#!/bin/bash TOMCAT_HOME/opt/tomcats/tomcat-portal WAR_SOURCE/data/new-releases/customer-portal.war BACKUP_DIR/data/backups/$(date %Y%m%d_%H%M%S) echo “停止Tomcat服務(wù)...” systemctl stop tomcat-portal echo “備份舊應(yīng)用...” mkdir -p $BACKUP_DIR cp -r $TOMCAT_HOME/webapps/customer-portal* $BACKUP_DIR/ 2/dev/null || true echo “清理工作目錄...” rm -rf $TOMCAT_HOME/webapps/customer-portal* rm -rf $TOMCAT_HOME/work/Catalina/localhost/customer-portal echo “部署新WAR包...” cp $WAR_SOURCE $TOMCAT_HOME/webapps/ echo “啟動(dòng)Tomcat服務(wù)...” systemctl start tomcat-portal echo “等待應(yīng)用啟動(dòng)...” sleep 30 # 可以添加一個(gè)健康檢查例如curl應(yīng)用的健康端點(diǎn) if curl -s --max-time 10 http://localhost:8080/customer-portal/health /dev/null; then echo “部署成功” else echo “部署可能存在問題請(qǐng)檢查日志$TOMCAT_HOME/logs/catalina.out” fi記得給腳本執(zhí)行權(quán)限chmod x deploy-portal.sh。7. 常見問題排查與解決方案實(shí)錄在實(shí)際操作中你幾乎一定會(huì)遇到一些問題。這里記錄了幾個(gè)最常見的問題和我的排查思路。7.1 端口沖突問題問題現(xiàn)象啟動(dòng)第二個(gè)Tomcat實(shí)例時(shí)失敗日志中報(bào)java.net.BindException: Address already in use。排查步驟確認(rèn)錯(cuò)誤端口查看日志明確是哪個(gè)端口被占用例如8081、8006。查找占用進(jìn)程使用netstat或lsof命令。# 查看8081端口被誰占用 netstat -tlnp | grep :8081 # 或 lsof -i :8081分析原因被其他服務(wù)占用可能是其他軟件如Nginx、另一個(gè)Tomcat占用了該端口。如果是修改沖突方的端口或停止該服務(wù)。被自己的僵尸進(jìn)程占用有時(shí)Tomcat非正常關(guān)閉進(jìn)程未完全退出。使用ps -ef | grep tomcat找到殘留進(jìn)程用kill -9 PID強(qiáng)制結(jié)束。配置未生效確認(rèn)修改的是正確的server.xml文件并且重啟了Tomcat。7.2 應(yīng)用啟動(dòng)失敗但Tomcat本身正常問題現(xiàn)象訪問應(yīng)用URL返回404或500錯(cuò)誤但Tomcat默認(rèn)首頁http://ip:port可以訪問。排查步驟檢查部署位置確認(rèn)WAR包或應(yīng)用目錄是否在正確的webapps目錄下。查看應(yīng)用專屬日志Tomcat會(huì)在logs目錄下為每個(gè)應(yīng)用生成一個(gè)日志文件如localhost_customer-portal_yyyy-MM-dd.log。這里是應(yīng)用初始化失敗信息的第一現(xiàn)場(chǎng)。查看Catalina日志重點(diǎn)查看catalina.out和localhost.log尋找SEVERE或ERROR級(jí)別的日志通常會(huì)有詳細(xì)的堆棧跟蹤。常見原因數(shù)據(jù)庫(kù)連接失敗檢查應(yīng)用配置的數(shù)據(jù)庫(kù)IP、端口、用戶名密碼。依賴缺失檢查WEB-INF/lib下是否有所有必需的JAR包。對(duì)于Spring Boot項(xiàng)目通常一個(gè)可執(zhí)行JAR或WAR包已包含所有依賴。內(nèi)存不足檢查catalina.out是否有OutOfMemoryError。需要調(diào)整JAVA_OPTS中的-Xmx參數(shù)。文件權(quán)限問題確保Tomcat進(jìn)程用戶如root或tomcat用戶對(duì)應(yīng)用目錄、臨時(shí)目錄有讀寫權(quán)限。7.3 服務(wù)無法開機(jī)自啟問題現(xiàn)象配置了systemd服務(wù)并enable了但服務(wù)器重啟后Tomcat沒有啟動(dòng)。排查步驟檢查服務(wù)狀態(tài)systemctl status tomcat-portal看是否顯示active (running)。查看服務(wù)日志journalctl -u tomcat-portal -xe這里會(huì)有詳細(xì)的啟動(dòng)失敗信息。常見原因依賴服務(wù)未就緒在tomcat-portal.service的[Unit]部分可以增加對(duì)網(wǎng)絡(luò)或數(shù)據(jù)庫(kù)的依賴?yán)鏏fternetwork.target mysqld.service。環(huán)境變量問題systemd服務(wù)文件中的JAVA_HOME路徑可能不正確。使用which java和readlink -f $(which java)找到準(zhǔn)確的JAVA_HOME路徑。啟動(dòng)超時(shí)如果應(yīng)用啟動(dòng)非常慢可能超過systemd默認(rèn)的超時(shí)時(shí)間默認(rèn)90秒?？梢栽赱Service]部分增加TimeoutStartSec300來延長(zhǎng)等待時(shí)間。7.4 如何優(yōu)雅地更新應(yīng)用直接替換WAR包Tomcat會(huì)嘗試熱部署但在復(fù)雜應(yīng)用中容易出錯(cuò)。我推薦的流程是通過systemctl停止服務(wù)systemctl stop tomcat-portal。備份舊應(yīng)用和日志可選但建議。刪除webapps下的舊應(yīng)用目錄和WAR包同時(shí)刪除work/Catalina/localhost下對(duì)應(yīng)的緩存目錄。放入新的WAR包。通過systemctl啟動(dòng)服務(wù)systemctl start tomcat-portal。通過tail -f監(jiān)控日志直到看到應(yīng)用啟動(dòng)成功的標(biāo)志。這種“停止-清理-部署-啟動(dòng)”的模式比熱部署更穩(wěn)定對(duì)于絕大多數(shù)應(yīng)用來說幾十秒的停機(jī)時(shí)間是可以接受的。如果要求零停機(jī)則需要設(shè)計(jì)藍(lán)綠部署或滾動(dòng)更新方案這通常需要結(jié)合負(fù)載均衡器和更復(fù)雜的腳本。