簡(jiǎn)介Apache Tomcat 10.0.13 Windows 64 位官方版面向 Java Web 開(kāi)發(fā)者、運(yùn)維人員及 Servlet/JSP 學(xué)習(xí)者提供輕量級(jí)應(yīng)用服務(wù)器發(fā)行包便于搭建本地運(yùn)行環(huán)境、部署測(cè)試 Web 應(yīng)用并了解 Tomcat 的核心組件與目錄組織。壓縮包共 644 個(gè)文件約 12.58MB以 html 文檔、class 與 java 源碼示例、jsp 頁(yè)面、jar 庫(kù)為主并含 xml/properties 配置、bat/sh 腳本、圖片與說(shuō)明文件覆蓋 bin、conf、lib、logs、webapps、work 等典型結(jié)構(gòu)。已有 278 人瀏覽學(xué)習(xí)。其價(jià)值在于保留官方發(fā)行包的原始文件組成便于讀者查閱 Catalina、Jasper、Coyote 相關(guān)資料結(jié)合配置文件和示例應(yīng)用理解服務(wù)注冊(cè)、WAR 部署、安全配置與性能調(diào)優(yōu)思路也適合作為課程實(shí)驗(yàn)、項(xiàng)目聯(lián)調(diào)和版本對(duì)照的參考包。1. 一臺(tái)沒(méi)有外網(wǎng)的 Windows 機(jī)器和一份解壓即用的 apache tomcat 10.0.13接手內(nèi)網(wǎng)交付的活最怕對(duì)面丟一句「裝個(gè) Tomcat 就行」。機(jī)器上沒(méi)外網(wǎng)、沒(méi)管理員密碼、JDK 還是半年前別人隨手裝的這時(shí)候 MSI 安裝包反而成了負(fù)擔(dān)寫(xiě)注冊(cè)表、搶端口、卸載還留一堆尾巴。apache tomcat 的 windows-x64 壓縮包正好相反解壓、設(shè)兩個(gè)環(huán)境變量、跑 startup.bat一個(gè)能接 WAR 的 Servlet 容器就立在 D 盤(pán)了要挪走刪目錄就行。但 10.0.13 卡在一個(gè)特殊位置——它實(shí)現(xiàn)的是 Jakarta EE 9lib 里只有 jakarta.* 的 API拿它接老項(xiàng)目會(huì)當(dāng)場(chǎng)翻車(chē)。這篇按我實(shí)際部署的順序把這份包從解壓、Connector 參數(shù)、服務(wù)注冊(cè)到 javax 遷移和排錯(cuò)拆一遍適合要在 Windows 上快速起一個(gè)容器的人。2. 解壓到跑起來(lái)路徑、環(huán)境變量與第一個(gè) WAR這一章的目標(biāo)很單一從拿到壓縮包到瀏覽器里看到你自己的頁(yè)面。步驟不多但 Windows 上幾個(gè)老毛病路徑帶空格、JRE_HOME 搶優(yōu)先級(jí)、雙擊閃退會(huì)讓人卡半小時(shí)以上。2.1 解壓路徑與環(huán)境變量的硬約束先說(shuō)路徑。不要解壓到C:\Program Files\下面一是路徑里有空格某些腳本拼接 classpath 時(shí)會(huì)斷二是這個(gè)目錄受 UAC 保護(hù)服務(wù)方式啟動(dòng)時(shí)權(quán)限容易出問(wèn)題。我一般固定放D:\server\下目錄名保持壓縮包原名不加中文、不加版本后綴說(shuō)明REM 解壓后的目錄形如 D:\server\apache-tomcat-10.0.13 REM 先確認(rèn) bin 目錄下同時(shí)存在 startup.bat 與 tomcat10.exe dir /b D:\server\apache-tomcat-10.0.13\bintomcat10.exe和tomcat10w.exe是這個(gè) windows-x64 包特有的壓縮包里帶了 procrun 包裝器后面注冊(cè) Windows 服務(wù)就靠它。如果你下載到的包里沒(méi)有這兩個(gè) exe說(shuō)明拿到的是通用 zip服務(wù)注冊(cè)會(huì)走另一條路。環(huán)境變量只設(shè)一個(gè)JAVA_HOME指向 JDK 根目錄不是 binsetx JAVA_HOME C:\Program Files\Java\jdk1.8.0_341 /M setx PATH %PATH%;%JAVA_HOME%\bin /M這里有個(gè)血淚經(jīng)驗(yàn)Tomcat 的setclasspath.bat判斷順序是先看 JRE_HOME再看 JAVA_HOME。很多機(jī)器上裝著老版本 JRE 并設(shè)了JRE_HOME結(jié)果啟動(dòng)日志里的 JVM 版本跟你以為的完全不一樣跑起來(lái)報(bào)UnsupportedClassVersionError才知道用錯(cuò)了。要么把JRE_HOME刪掉要么讓它跟JAVA_HOME指向同一個(gè) JDK。10.0.x 這條線最低要 Java 8裝 JDK 8 或 11 都能跑。REM 驗(yàn)證輸出的路徑必須指向 JDK且位數(shù)與包匹配x64 包里是 64 位包裝器 echo %JAVA_HOME% %JAVA_HOME%\bin\java -version2.2 七個(gè)目錄各管什么解壓完先別急著啟動(dòng)花兩分鐘認(rèn)一下目錄后面出問(wèn)題能少走彎路目錄作用能否清空常見(jiàn)誤用bin啟動(dòng)腳本、service.bat、tomcat10.exe否把setenv.bat放到別處導(dǎo)致不生效confserver.xml、web.xml、context.xml、tomcat-users.xml否直接改web.xml全局配置升級(jí)被覆蓋lib容器級(jí) jar含jakarta.servlet-api等否往這里塞業(yè)務(wù) jar和 webapp 類加載器打架logscatalina、localhost、localhost_access_log可出問(wèn)題只看控制臺(tái)不看這里的完整堆棧temp上傳臨時(shí)目錄、文件鎖停服后可服務(wù)運(yùn)行中刪導(dǎo)致上傳報(bào)錯(cuò)webapps默認(rèn)部署目錄可生產(chǎn)環(huán)境留著manager、host-manager、docsworkJSP 編譯產(chǎn)物停服后可改 JSP 不生效時(shí)忘了清這里work那一行值得單獨(dú)說(shuō)JSP 第一次訪問(wèn)會(huì)被編譯成 Servlet 落在work\Catalina\localhost\應(yīng)用名\下改完 JSP 沒(méi)反應(yīng)八成是時(shí)間戳沒(méi)觸發(fā)重編譯停服刪work目錄再起就好。生產(chǎn)環(huán)境把manager、host-manager、docs、examples四個(gè)目錄刪掉這是最省事的一刀。2.3 啟動(dòng)與部署第一個(gè) WAR啟動(dòng)有兩種方式區(qū)別很大REM 方式一新開(kāi)窗口啟動(dòng)窗口一閃而過(guò)時(shí)你看不到任何報(bào)錯(cuò) cd /d D:\server\apache-tomcat-10.0.13\bin startup.bat REM 方式二前臺(tái)運(yùn)行日志直接打在當(dāng)前窗口排錯(cuò)首選 cd /d D:\server\apache-tomcat-10.0.13\bin catalina.bat run新手最常踩的坑就是雙擊startup.bat窗口閃一下就沒(méi)了然后說(shuō)「啟動(dòng)不了」。它其實(shí)只是「啟動(dòng)失敗并關(guān)閉了窗口」。用catalina.bat run前臺(tái)跑異常堆棧會(huì)老老實(shí)實(shí)打出來(lái)。看到Server startup in [xxxx] milliseconds才算真正起來(lái)了。部署一個(gè) WAR 就是把文件拷進(jìn)webappsREM 拷貝即部署文件名決定訪問(wèn)路徑demo-app.war 對(duì)應(yīng) /demo-app copy /Y D:\build\demo-app.war D:\server\apache-tomcat-10.0.13\webapps\ REM 想看部署過(guò)程盯 catalina 日志的最新一份 dir /o-d D:\server\apache-tomcat-10.0.13\logs\catalina.*.log這里有兩個(gè)要點(diǎn)。第一Host的autoDeploy和unpackWARs默認(rèn)都是true容器會(huì)自己解包、自己建 Context不需要你寫(xiě)任何配置第二文件名就是 context pathROOT.war才會(huì)映射到根路徑/改名demo-app.war之后訪問(wèn)地址立刻變成/demo-app很多人改完名忘了這點(diǎn)回頭訪問(wèn) 8080 根路徑得 404。2.4 起沒(méi)起來(lái)的三條驗(yàn)證別靠「瀏覽器沒(méi)報(bào)錯(cuò)」判斷按這個(gè)順序確認(rèn)REM 1. 端口在不在監(jiān)聽(tīng) netstat -ano | findstr :8080 REM 2. 容器自身是否響應(yīng) curl -I http://127.0.0.1:8080/ REM 3. 日志里有沒(méi)有 SEVERE findstr /I SEVERE ERROR D:\server\apache-tomcat-10.0.13\logs\catalina.*.logcurl -I返回200或404都說(shuō)明容器活著404 只是根應(yīng)用不存在連不上才是容器沒(méi)起來(lái)。第三步那行findstr最好養(yǎng)成習(xí)慣有些應(yīng)用啟動(dòng)時(shí)報(bào)了SEVERE但容器照樣對(duì)外服務(wù)等到第一次請(qǐng)求才炸。提示確認(rèn)能用之后把conf\server.xml里port8005的 shutdown 端口和port8080都記下來(lái)同一臺(tái)機(jī)器跑第二個(gè)實(shí)例時(shí)必須改否則第二個(gè)實(shí)例起不來(lái)還不報(bào)明顯錯(cuò)誤。3. server.xml 與 Connector把 8080 調(diào)成能扛事的樣子出廠server.xml是給「跑通」用的不是給「跑穩(wěn)」用的。這一章處理三個(gè)真問(wèn)題Connector 參數(shù)怎么定、應(yīng)用目錄放哪、怎么變成開(kāi)機(jī)自啟的 Windows 服務(wù)。3.1 Connector 的六個(gè)必調(diào)參數(shù)先看默認(rèn) Connector 長(zhǎng)什么樣再逐項(xiàng)改!-- conf/server.xml 中 Service 節(jié)點(diǎn)內(nèi)的 HTTP Connector -- Connector port8080 protocolorg.apache.coyote.http11.Http11NioProtocol address0.0.0.0 connectionTimeout20000 maxThreads400 minSpareThreads50 acceptCount200 maxConnections8192 URIEncodingUTF-8 compressionon compressionMinSize2048 compressibleMimeTypetext/html,text/xml,text/plain,text/css,application/json,application/javascript relaxedQueryChars[]|{}^#x5c;#x60;quot;lt;gt; redirectPort8443 /protocol顯式寫(xiě)成Http11NioProtocol是為了避免不同 JDK 上自動(dòng)選擇帶來(lái)的行為差異也讓后來(lái)接手的人一眼看出用的是 NIO。connectionTimeout屬性本身的默認(rèn)值是 60000 毫秒出廠文件里寫(xiě)的是 20000內(nèi)網(wǎng)應(yīng)用 20 秒夠用對(duì)外服務(wù)建議拉到 30000 以上否則慢接口會(huì)被容器直接掐斷連接。maxThreads是最容易被拍腦袋設(shè)的參數(shù)。默認(rèn) 200它對(duì)應(yīng)的是并發(fā)正在處理的請(qǐng)求數(shù)不是連接數(shù)。經(jīng)驗(yàn)值是按「單機(jī) CPU 核數(shù) × 25」估一個(gè)起點(diǎn)IO 密集的應(yīng)用可以往上加純計(jì)算型的加到 400 反而會(huì)因?yàn)榫€程切換變慢。acceptCount是隊(duì)列長(zhǎng)度線程打滿后新連接堆在這里超過(guò)就拒絕內(nèi)網(wǎng)應(yīng)用 200 足夠公網(wǎng)入口要跟前面的負(fù)載均衡策略對(duì)上。relaxedQueryChars這一項(xiàng)是真正的后悔藥。Tomcat 從 8.0 開(kāi)始嚴(yán)格校驗(yàn)請(qǐng)求行里的字符URL 里帶|、{、}、[、]一律返回 400前端把 JSON 直接拼在 query string 里時(shí)必翻車(chē)。注意 XML 里不能寫(xiě)裸的、、要用字符引用上面那串#x5c;#x60;quot;lt;gt;就是反斜杠、反引號(hào)、雙引號(hào)、尖括號(hào)的轉(zhuǎn)義寫(xiě)法抄的時(shí)候別漏。3.2 應(yīng)用目錄放哪三種部署方式的選擇WAR 丟webapps是開(kāi)發(fā)期最省事的方式但升級(jí) Tomcat 時(shí)整個(gè)目錄要換應(yīng)用配置會(huì)跟著丟。我一般用第三種方式把配置和容器解耦!-- conf/Catalina/localhost/demo-app.xml文件名即 context path -- ?xml version1.0 encodingUTF-8? Context docBaseD:/apps/demo-app reloadablefalse crossContextfalse Manager pathname / /ContextdocBase指向容器外的目錄用正斜杠或轉(zhuǎn)義反斜杠這樣 Tomcat 升級(jí)只要換CATALINA_HOME業(yè)務(wù)文件原地不動(dòng)。reloadablefalse是生產(chǎn)環(huán)境的必須項(xiàng)設(shè)成true時(shí)容器會(huì)不停掃描 class 變更CPU 白燒而且熱加載常常只重載了一半的類引發(fā)各種ClassCastException。Manager pathname /關(guān)掉 Session 持久化到磁盤(pán)很多莫名其妙的「重啟后拿到臟 Session」就是它引起的如果確實(shí)要重啟保留會(huì)話就配PersistentManager和FileStore別用默認(rèn)行為。還有一種是把META-INF/context.xml打進(jìn) WAR 里方便但耦合同一份 WAR 想在不同環(huán)境用不同數(shù)據(jù)源就難受了。選型上我的排序是外部 xml WAR 內(nèi)置 直接改server.xml里的 Context。3.3 注冊(cè)成 Windows 服務(wù)service.bat 的實(shí)際用法交付到客戶現(xiàn)場(chǎng)沒(méi)人愿意每次登錄服務(wù)器手動(dòng)跑 bat。這個(gè)包帶service.bat一條命令注冊(cè)成服務(wù)cd /d D:\server\apache-tomcat-10.0.13\bin REM 安裝服務(wù)并指定初始堆注意服務(wù)名只能英文數(shù)字不要帶空格 service.bat install Tomcat10Demo --Startup auto --JvmMs 2048 --JvmMx 4096 REM 啟動(dòng)并確認(rèn)狀態(tài) net start Tomcat10Demo sc query Tomcat10Demo REM 改內(nèi)存參數(shù)不用重裝update 即可 service.bat update Tomcat10Demo --JvmMs 2048 --JvmMx 4096 REM 卸載 net stop Tomcat10Demo service.bat remove Tomcat10Demo幾個(gè)必須知道的邊界。第一服務(wù)注冊(cè)時(shí)記錄的是當(dāng)前目錄作為CATALINA_HOME所以一定要先cd到 bin 再執(zhí)行否則服務(wù)指向一個(gè)不存在的路徑啟動(dòng)時(shí)報(bào)錯(cuò)還很難查。第二服務(wù)默認(rèn)以 LocalSystem 身份運(yùn)行如果你的應(yīng)用要訪問(wèn)網(wǎng)絡(luò)共享目錄或者別的用戶配置下的文件權(quán)限會(huì)跟你在桌面上雙擊啟動(dòng)時(shí)完全不同這類「本地能跑、服務(wù)跑不了」的問(wèn)題十有八九是這里。第三--JvmMx不要超過(guò)機(jī)器可用內(nèi)存的六成設(shè)大了服務(wù)啟動(dòng)直接失敗錯(cuò)誤只寫(xiě)在logs\commons-daemon.*.log里事件查看器里看到的只是一個(gè) 1067。裝好之后想改 JVM 參數(shù)除了service.bat update也可以直接運(yùn)行tomcat10w.exe //ES//Tomcat10Demo打開(kāi)圖形配置界面Java 選項(xiàng)卡里改 Initial/Maximum memory pool。這個(gè) exe 的//ES//參數(shù)后面必須跟準(zhǔn)確的服務(wù)名名字寫(xiě)錯(cuò)就靜默退出什么都不提示。3.4 setenv.batJVM 參數(shù)該寫(xiě)在哪不要直接改catalina.bat升級(jí)一次全丟。正確做法是在bin下新建setenv.bat容器啟動(dòng)時(shí)會(huì)自動(dòng)調(diào)用echo off REM setenv.bat 放在 %CATALINA_BASE%\bin 下不是 CATALINA_HOME set CATALINA_OPTS-Xms2g -Xmx2g -XX:MetaspaceSize256m -XX:MaxMetaspaceSize512m set CATALINA_OPTS%CATALINA_OPTS% -Dfile.encodingUTF-8 -Duser.timezoneAsia/Shanghai set CATALINA_OPTS%CATALINA_OPTS% -XX:HeapDumpOnOutOfMemoryError -XX:HeapDumpPathD:\logs\heap set JAVA_OPTS%JAVA_OPTS% -Djava.awt.headlesstrueJAVA_OPTS和CATALINA_OPTS的區(qū)別值得記牢JAVA_OPTS會(huì)傳給version、stop這些命令CATALINA_OPTS只傳給真正啟動(dòng) Tomcat 的那個(gè)進(jìn)程。所以內(nèi)存參數(shù)、GC 參數(shù)放CATALINA_OPTS避免停服務(wù)的時(shí)候也去申請(qǐng) 2G 堆。-Xms和-Xmx設(shè)成一樣大是為了避免運(yùn)行期擴(kuò)堆代價(jià)是啟動(dòng)時(shí)就把內(nèi)存占住交付到內(nèi)存緊張的機(jī)器上要往下調(diào)。HeapDumpOnOutOfMemoryError那個(gè)路徑必須先建好目錄容器不會(huì)替你創(chuàng)建OOM 時(shí)路徑不存在堆轉(zhuǎn)儲(chǔ)就靜默丟了這算是典型的「配了等于沒(méi)配」。4. javax 到 jakarta10.0.13 最容易踩的遷移坑這一節(jié)是整份包里最需要提前知道的事。10.0.13 不是「9 的補(bǔ)丁版」它換掉了整個(gè) API 命名空間。4.1 老 WAR 扔進(jìn)去為什么直接報(bào)錯(cuò)現(xiàn)象很固定應(yīng)用部署上去日志里出現(xiàn)java.lang.NoClassDefFoundError: javax/servlet/http/HttpServlet或者ClassNotFoundException: javax.servlet.Filter又或者更詭異的——類都加載成功了WebServlet注解標(biāo)注的接口卻 404。原因是 Tomcat 10.0 實(shí)現(xiàn) Jakarta EE 9Servlet 規(guī)范從 4.0 升到 5.0包名整體從javax.servlet.*改成jakarta.servlet.*。容器的lib里放的是jakarta.servlet-api根本沒(méi)有javax.servlet這個(gè)包。注解掃描也一樣它掃的是jakarta.servlet.annotation.WebServlet你代碼里寫(xiě)的是javax.servlet.annotation.WebServlet容器壓根不認(rèn)識(shí)這個(gè)注解于是接口注冊(cè)不上部署日志里連個(gè) WARN 都沒(méi)有。注意這不是配置問(wèn)題改任何server.xml都解決不了。要么把應(yīng)用遷移到 jakarta要么換回 Tomcat 9 那條 javax 線二選一。選型上給個(gè)直白的判斷Spring Boot 2.x 及更早打出來(lái)的 WAR直接上 Tomcat 9Spring Boot 3.x 或者自己維護(hù) Servlet 代碼的項(xiàng)目用 10.x。中間沒(méi)有既省錢(qián)又省事的第三條路。4.2 遷移檢查從依賴樹(shù)到字節(jié)碼遷移第一步不是改代碼是先摸清有多少 javax 依賴混在里面REM 只篩 servlet / websocket / el 這三類輸出重定向到文件方便比對(duì) mvn -f D:\src\demo-app\pom.xml dependency:tree -Dincludesjavax.servlet:*,javax.websocket:*,javax.el:* D:\build\deps.txt findstr /I javax.servlet jakarta.servlet D:\build\deps.txt輸出里但凡出現(xiàn)javax.servlet:javax.servlet-api、javax.servlet:jstl這類坐標(biāo)就得換。換的時(shí)候注意傳遞依賴很多老框架自己不聲明 servlet-api靠的就是容器提供你換成 jakarta 之后它的內(nèi)部字節(jié)碼還是 javax這時(shí)候只能升級(jí)框架版本。第二步改源碼。接口方法簽名不變變的只有包名// 遷移后的 Filter包名全部換成 jakarta方法簽名與原來(lái)一致 import jakarta.servlet.Filter; import jakarta.servlet.FilterChain; import jakarta.servlet.ServletException; import jakarta.servlet.http.HttpServletRequest; import jakarta.servlet.http.HttpServletResponse; public class DemoFilter implements Filter { Override public void doFilter(jakarta.servlet.ServletRequest request, jakarta.servlet.ServletResponse response, FilterChain chain) throws java.io.IOException, ServletException { // 業(yè)務(wù)邏輯完全不用動(dòng)只有類型所在的包變了 chain.doFilter(request, response); } }全局替換時(shí)有個(gè)陷阱別把字符串常量里的javax.servlet一起替換掉。有些項(xiàng)目把類名寫(xiě)進(jìn)了反射配置或者 XML替換錯(cuò)了要跑起來(lái)才發(fā)現(xiàn)。IDE 的「替換全部」務(wù)必限定在*.java的 import 與類型引用范圍內(nèi)替換完git diff掃一眼。第三步改描述符。web.xml的版本號(hào)和 schema 位置都要跟著升!-- Servlet 5.0 的命名空間注意是 jakarta.ee不是 java.sun.com -- web-app xmlnshttps://jakarta.ee/xml/ns/jakartaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttps://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd version5.0 display-namedemo-app/display-name /web-appJSP 那邊同樣要?jiǎng)覬STL 的 taglib uri 從http://java.sun.com/jsp/jstl/core改成jakarta.tags.core并且WEB-INF/lib下要放 JSTL 3.0 的實(shí)現(xiàn)用 1.2 的實(shí)現(xiàn)照樣跑不起來(lái)。第四步改完別急著部署先用javap在字節(jié)碼層面復(fù)核一遍這一步能提前攔住 90% 的漏網(wǎng)之魚(yú)REM 解包 WAR 后用 javap 反查常量池里還有沒(méi)有 javax/servlet 引用 cd /d D:\build\demo-app-unpacked\WEB-INF\classes javap -p -c com\example\demo\DemoServlet | findstr /I javax servlet輸出為空才算干凈。要批量查整個(gè)目錄寫(xiě)個(gè)循環(huán)把WEB-INF\classes下所有 class 過(guò)一遍比人眼翻代碼可靠得多。4.3 兩個(gè)命名空間能不能共存這是被問(wèn)得最多的問(wèn)題能不能把javax.servlet-api.jar塞進(jìn)WEB-INF/lib讓老 WAR 直接跑在 10.0.13 上技術(shù)上類能加載但沒(méi)用。Tomcat 內(nèi)部是按jakarta.servlet.Servlet這個(gè)類型去識(shí)別和調(diào)用組件的你的 Servlet 實(shí)現(xiàn)的是javax.servlet.Servlet兩者不是同一個(gè)類型容器在掃描階段就把它當(dāng)普通類跳過(guò)了不會(huì)注冊(cè)路由不會(huì)調(diào)用init。所以你最多能做到「不報(bào) ClassNotFound」但請(qǐng)求還是 404問(wèn)題從顯式報(bào)錯(cuò)變成了隱形失敗更難查。真要少改代碼有個(gè)折中思路是用字節(jié)碼遷移工具批量把 class 里的javax/servlet常量池引用改成jakarta/servletWAR 解包、批量改、重新打包。這條路對(duì)純 Servlet/JSP 項(xiàng)目有效對(duì)依賴了框架內(nèi)部反射、動(dòng)態(tài)代理、OSGi 的應(yīng)用就不一定了框架內(nèi)部可能硬編碼了類名字符串改字節(jié)碼改不到。所以我的建議是能升級(jí)依賴就升級(jí)不能升級(jí)就老老實(shí)實(shí)選 Tomcat 9別在中間地帶耗時(shí)間。5. 排查清單五個(gè)把服務(wù)卡在啟動(dòng)階段的坑下面五條是我在 Windows 上部署 Tomcat 時(shí)反復(fù)遇到的按「現(xiàn)象 → 原因 → 解決」記遇到同類問(wèn)題可以直接對(duì)號(hào)。5.1 雙擊 startup.bat 窗口一閃而過(guò)現(xiàn)象雙擊startup.bat黑窗口閃一下就關(guān)閉瀏覽器訪問(wèn) 8080 無(wú)響應(yīng)logs目錄里也沒(méi)新日志。原因startup.bat會(huì)用start新開(kāi)一個(gè)窗口跑catalina.bat如果JAVA_HOME沒(méi)設(shè)、指向 JRE、或者位數(shù)不匹配64 位包裝器配 32 位 JVM子進(jìn)程立刻退出父窗口也就跟著關(guān)了錯(cuò)誤信息全丟在已經(jīng)關(guān)閉的子窗口里。解決永遠(yuǎn)用catalina.bat run前臺(tái)啟動(dòng)看第一手報(bào)錯(cuò)。如果是JRE_HOME干擾臨時(shí)set JRE_HOME再啟動(dòng)驗(yàn)證如果是位數(shù)問(wèn)題%JAVA_HOME%\bin\java -version輸出里會(huì)帶64-Bit字樣對(duì)不上就換 JDK。5.2 8080 端口被占用或第二個(gè)實(shí)例起不來(lái)現(xiàn)象啟動(dòng)日志末尾報(bào)Address already in use: bind或者機(jī)器上跑第二個(gè) Tomcat 時(shí)明明改了 8080 還是失敗。原因除了 HTTP 的 8080server.xml里還有shutdown端口 8005 和 AJP 端口 8009三個(gè)都要改只改一個(gè)必然沖突。另外 Windows 上 8080 常被別的服務(wù)占著。解決先查占用再動(dòng)手REM 查出占用 8080 的進(jìn)程 PID確認(rèn)是不是自己的舊實(shí)例 netstat -ano | findstr :8080 tasklist | findstr 上一步查到的PID REM 確認(rèn)可以殺再殺別誤殺別的服務(wù) taskkill /PID PID /F多個(gè)實(shí)例共存時(shí)把shutdown端口改成 8006、8007 依次遞增AJP 那段在 10.0.x 里默認(rèn)是注釋掉的不用管。5.3 中文亂碼但只在某一種場(chǎng)景下亂現(xiàn)象控制臺(tái)啟動(dòng)日志里中文變問(wèn)號(hào)或者頁(yè)面正常但 GET 參數(shù)亂碼或者反過(guò)來(lái)頁(yè)面亂碼日志正常。原因三種亂碼三個(gè)根因?？刂婆_(tái)亂碼是 cmd 的代碼頁(yè)默認(rèn) 936和 JVM 的file.encoding不一致GET 參數(shù)亂碼在 Tomcat 8 之后已經(jīng)很少見(jiàn)因?yàn)閁RIEncoding默認(rèn)就是 UTF-8問(wèn)題通常出在前端沒(méi)做encodeURIComponent或者網(wǎng)關(guān)轉(zhuǎn)了一道響應(yīng)亂碼則是Content-Type里沒(méi)帶charsetUTF-8。解決setenv.bat里加-Dfile.encodingUTF-8cmd 里執(zhí)行chcp 65001再看日志。響應(yīng)側(cè)統(tǒng)一在過(guò)濾器里設(shè)response.setCharacterEncoding(UTF-8)或者由框架的編碼過(guò)濾器兜底。注意別在server.xml里再手動(dòng)寫(xiě)URIEncodingISO-8859-1那是給老版本擦屁股的寫(xiě)法現(xiàn)在寫(xiě)上去只會(huì)制造新問(wèn)題。5.4 請(qǐng)求返回 400日志說(shuō) Invalid character現(xiàn)象某些帶參數(shù)的 URL 一訪問(wèn)就 400日志里是Invalid character found in the request target把參數(shù)刪掉就正常。原因Tomcat 嚴(yán)格按 RFC 校驗(yàn)請(qǐng)求行|、{、}、[、]、反斜杠這些字符默認(rèn)不允許出現(xiàn)在 URL 里。前端把 JSON、數(shù)組參數(shù)直接拼進(jìn) query string 時(shí)必中。解決在 Connector 上加relaxedQueryChars路徑里也可能出現(xiàn)的話再加relaxedPathChars。寫(xiě)的時(shí)候注意 XML 轉(zhuǎn)義、、都要用字符引用否則server.xml直接解析失敗容器起不來(lái)報(bào)的還是一句很含糊的Error parsing server.xml。改完先跑catalina.bat run確認(rèn)能起來(lái)再掛服務(wù)。5.5 服務(wù)裝上了net start 報(bào) 1067 或 1053現(xiàn)象service.bat install提示成功sc query能看到服務(wù)但net start立刻失敗事件查看器里只有「進(jìn)程意外終止」。原因service.bat注冊(cè)時(shí)記錄的是執(zhí)行命令那一刻的當(dāng)前目錄。如果你在別的目錄執(zhí)行或者先裝服務(wù)再挪了 Tomcat 目錄服務(wù)指向的路徑就是錯(cuò)的。另一個(gè)常見(jiàn)原因是--JvmMx設(shè)得超過(guò)物理內(nèi)存JVM 起不來(lái)服務(wù)管理器只報(bào)一個(gè)籠統(tǒng)的錯(cuò)誤碼。解決錯(cuò)誤細(xì)節(jié)在logs\commons-daemon.YYYY-MM-DD.log里第一行通常就寫(xiě)著真正的失敗原因。路徑錯(cuò)就service.bat remove后cd到 bin 重裝內(nèi)存參數(shù)錯(cuò)就service.bat update往下調(diào)。順手確認(rèn)服務(wù)名沒(méi)寫(xiě)錯(cuò)tomcat10w.exe //ES//服務(wù)名里的名字必須和sc query看到的完全一致。6. 進(jìn)階日志切分、訪問(wèn)日志與一份程序跑多實(shí)例容器能跑只是及格線交付到現(xiàn)場(chǎng)還得管兩件事日志別把磁盤(pán)寫(xiě)爆以及一臺(tái)機(jī)器上跑多個(gè)環(huán)境。Tomcat 的日志走 JULI配置在conf\logging.properties。出廠配置里catalina日志是按天滾動(dòng)的但保留天數(shù)是 90 天且單個(gè)文件不限大小業(yè)務(wù)日志一多l(xiāng)ogs目錄很快就上 G。我的習(xí)慣是把關(guān)鍵幾行調(diào)成下面這樣重點(diǎn)在maxDays和rotatable# conf/logging.properties 片段 # 1catalina.org.apache.juli.AsyncFileHandler.level FINE 1catalina.org.apache.juli.AsyncFileHandler.directory ${catalina.base}/logs 1catalina.org.apache.juli.AsyncFileHandler.prefix catalina. 1catalina.org.apache.juli.AsyncFileHandler.suffix .log 1catalina.org.apache.juli.AsyncFileHandler.maxDays 15 1catalina.org.apache.juli.AsyncFileHandler.rotatable true 1catalina.org.apache.juli.AsyncFileHandler.bufferSize 8192訪問(wèn)日志默認(rèn)不開(kāi)需要自己在Host里加 Valve。開(kāi)了之后每一條請(qǐng)求一行排查慢請(qǐng)求、確認(rèn) caller IP 全靠它!-- conf/server.xml 的 Host 節(jié)點(diǎn)內(nèi)rotatable 讓文件按天切 -- Valve classNameorg.apache.catalina.valves.AccessLogValve directorylogs prefixaccess. suffix.log pattern%{yyyy-MM-dd HH:mm:ss}t %h %l %u quot;%rquot; %s %b %D rotatabletrue /pattern里的%D是處理耗時(shí)毫秒這個(gè)字段比什么都值錢(qián)接口慢不慢一眼就看出來(lái)。%h記客戶端 IP前面掛了反向代理的話要換成%{X-Forwarded-For}i否則所有請(qǐng)求的 IP 都是代理機(jī)的。多實(shí)例的做法是拆CATALINA_BASECATALINA_HOME只留一份程序每個(gè)實(shí)例目錄下復(fù)制conf、logs、temp、webapps、work五個(gè)目錄然后寫(xiě)個(gè)啟動(dòng)腳本分別指定REM 實(shí)例一端口 8080指向自己的 base 目錄 set CATALINA_HOMED:\server\apache-tomcat-10.0.13 set CATALINA_BASED:\server\instance-a call %CATALINA_HOME%\bin\catalina.bat runCATALINA_BASE下的bin\setenv.bat才是這個(gè)實(shí)例真正生效的那份很多人改了CATALINA_HOME\bin\setenv.bat發(fā)現(xiàn)不生效就是被 base 目錄里的同名文件覆蓋了。最后說(shuō)個(gè)驗(yàn)證習(xí)慣。壓測(cè)不用上大工具ab -n 2000 -c 100 http://127.0.0.1:8080/demo-app/api/ping打一輪同時(shí)開(kāi)個(gè)窗口看jstack里線程池的狀態(tài)http-nio-8080-exec-*線程數(shù)量一直貼著maxThreads上限說(shuō)明該調(diào)線程或者查慢 SQL 了而不是繼續(xù)往上加線程數(shù)。從那以后我每次落地一個(gè)新的 Tomcat 目錄都會(huì)先用catalina.bat run前臺(tái)跑一遍、看到Server startup in那行再掛服務(wù)配置錯(cuò)在啟動(dòng)階段就暴露比事后翻日志省事得多。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取