1. 先搞清楚為什么現(xiàn)在還有人要裝 JDK8打開任何一個(gè)后端招聘帖或者是老項(xiàng)目的部署文檔你會(huì)發(fā)現(xiàn)一個(gè)很奇怪的現(xiàn)象2024 年了新項(xiàng)目都在討論 JDK17、JDK21可偏偏有一大批系統(tǒng)還在 Windows 上用著 JDK8。這不是誰偷懶而是現(xiàn)實(shí)決定的。JDK8 是 Java 歷史上生命周期最長的一個(gè)版本2014 年發(fā)布到 2030 年前后都還有商業(yè)支持版本在跑大量企業(yè)內(nèi)部的中間件、老框架、定制化組件都建立在 JDK8 的語言特性和運(yùn)行機(jī)制之上。你把它換成高版本輕則啟動(dòng)報(bào)錯(cuò)重則字節(jié)碼不兼容、反射被模塊系統(tǒng)攔住排查成本高得離譜。所以我寫這篇東西不是教你點(diǎn)下一步就完事而是把這件看起來簡單的事講透。Windows 安裝 JDK8這件事表面是下載一個(gè)安裝包、配兩個(gè)環(huán)境變量真正容易翻車的點(diǎn)在于選哪個(gè)發(fā)行版、裝 32 位還是 64 位、JAVA_HOME 和 Path 到底誰管誰、機(jī)器上已經(jīng)有別的 JDK 怎么辦、命令行顯示版本不對怎么查。這些問題在搜索引擎上答案零散而且互相矛盾很多人配了半小時(shí)環(huán)境變量最后卡在java -version打印出另一個(gè)版本上。這篇文章適合三類人看第一類是完全沒接觸過 Java 環(huán)境配置的新手想一次裝對不折騰第二類是手上維護(hù)著老項(xiàng)目、需要在同一臺(tái) Windows 機(jī)器上讓 JDK8 和 JDK17 和平共處的開發(fā)者第三類是幫同事、幫客戶遠(yuǎn)程裝環(huán)境的技術(shù)支持人員需要一套能復(fù)現(xiàn)、能抄作業(yè)的標(biāo)準(zhǔn)流程。全文基于 Windows 10 和 Windows 11 的實(shí)測Windows Server 2016 及以上同樣適用涉及命令的地方我都會(huì)給出可直接粘貼的內(nèi)容。在動(dòng)手之前我建議你先在心里回答一個(gè)問題這臺(tái)機(jī)器上的 JDK8是唯一版本還是多個(gè)版本之一答案不同后面的配置策略完全不一樣。很多教程只講單版本裝法等你后面要裝第二個(gè) JDK 時(shí)環(huán)境變量一團(tuán)亂只能重裝系統(tǒng)級(jí)別的折騰。所以下面的內(nèi)容我會(huì)兩套都講并且告訴你為什么。1.1 JDK8 到底老在哪又強(qiáng)在哪先說清楚概念避免新手把 JDK 和 JRE 混為一談。JRE 是運(yùn)行環(huán)境只有java命令能跑 class 文件但不能編譯JDK 是開發(fā)工具包包含 JRE 外加javac、jar、javadoc、jps、jstack這些工具。你要做開發(fā)必須裝 JDK如果只是運(yùn)行別人打包好的程序裝 JRE 理論上夠用但實(shí)際工作中我建議一律裝 JDK因?yàn)榕挪閱栴}時(shí)jps、jstack、jmap這些工具是你唯一的救命稻草缺了它們線上問題只能靠猜。JDK8 相對 JDK7 最大的變化是引入了 Lambda 表達(dá)式和 Stream API讓 Java 第一次有了像樣的函數(shù)式寫法。還有接口默認(rèn)方法、方法引用、Optional 類、全新的日期時(shí)間 APIjava.time以及把永久代 PermGen 換成了元空間 Metaspace。這最后一條尤其重要以前 JDK7 跑久了報(bào)java.lang.OutOfMemoryError: PermGen space是無數(shù)人的噩夢JDK8 之后這個(gè)錯(cuò)誤基本消失了取而代之的是元空間溢出排查思路完全不同。如果你在維護(hù)老系統(tǒng)看到 PermGen 相關(guān)的報(bào)錯(cuò)那說明機(jī)器上跑的其實(shí)不是 JDK8或者是 JDK8 但參數(shù)里還留著-XX:MaxPermSize這種情況下 JVM 會(huì)直接警告參數(shù)無效。還有個(gè)細(xì)節(jié)很多人不知道JDK8 的file.encoding在 Windows 上默認(rèn)跟隨系統(tǒng)區(qū)域設(shè)置中文環(huán)境就是 GBK。而 JDK9 之后默認(rèn)改成了 UTF-8。這就導(dǎo)致同一個(gè)項(xiàng)目在 JDK8 上讀文件正常換到 JDK11 上中文全亂碼。反過來也一樣。所以當(dāng)你在 Windows 上裝 JDK8 時(shí)編碼問題一定要提前意識(shí)到不要等程序跑出亂碼才回頭找原因。1.2 哪些場景非 JDK8 不可我列幾個(gè)實(shí)際遇到過的場景你對照看看自己是不是其中之一。第一公司內(nèi)部的 ERP、OA、財(cái)務(wù)系統(tǒng)用的是十年前的框架比如 Struts2 加 Spring 3這些框架在高版本 JDK 上會(huì)直接拋異常。第二某些國產(chǎn)中間件、老版本的 Tomcat 7 或者 WebLogic官方支持的 JDK 上限就寫死在 8。第三大數(shù)據(jù)生態(tài)里Hadoop、Hive、Spark 的早期版本對 JDK8 依賴很深雖然新版本已經(jīng)支持 11 和 17但存量集群升級(jí)成本極高。第四教學(xué)和考試環(huán)境很多高校的 Java 課程、軟考、認(rèn)證考試仍然以 JDK8 為基準(zhǔn)。第五也是最現(xiàn)實(shí)的一條你接手了一個(gè)沒人敢動(dòng)的項(xiàng)目能跑就行別的事以后再說。這種時(shí)候正確的做法不是順便升級(jí)一下而是老老實(shí)實(shí)把 JDK8 裝好先讓系統(tǒng)穩(wěn)定運(yùn)行升級(jí)的事單獨(dú)排期評(píng)估。我見過太多人抱著順手升一升的心態(tài)把一個(gè)本來只是環(huán)境缺失的問題變成了兩周的兼容性改造。注意如果這臺(tái)機(jī)器是生產(chǎn)服務(wù)器裝 JDK8 之前一定要確認(rèn)應(yīng)用當(dāng)前的 JDK 版本和啟動(dòng)參數(shù)別想當(dāng)然認(rèn)為肯定是 8。用java -version和jps -lvm確認(rèn)清楚再動(dòng)手。2. 下載前的三個(gè)決定發(fā)行版、位數(shù)、安裝包類型很多人一上來就搜jdk8下載點(diǎn)進(jìn)第一個(gè)結(jié)果下載、裝完然后發(fā)現(xiàn)裝的是 JRE或者裝完是 32 位版本內(nèi)存上限被卡在 1.5G 左右跑什么都慢。這三個(gè)決定必須在下載之前想清楚否則后面全是返工。2.1 選哪個(gè)發(fā)行版別只盯著一個(gè)來源JDK8 的發(fā)行版有好幾個(gè)來源各有各的適用場景。我整理成表格你按自己的情況對號(hào)入座。發(fā)行版典型包名適合場景需要注意的點(diǎn)Oracle JDK 8jdk-8uXXX-windows-x64.exe傳統(tǒng)企業(yè)項(xiàng)目、老框架后期更新版本在授權(quán)條款上有變化商用前要確認(rèn)合規(guī)Eclipse Temurin 8OpenJDK8U-jdk_x64_windows_hotspot_8uXXX.zip通用開發(fā)、開源項(xiàng)目只提供壓縮包需要手動(dòng)配環(huán)境變量Amazon Corretto 8amazon-corretto-8-x64-windows-jdk.msi長期免費(fèi)支持、服務(wù)器安裝器行為與 Oracle 略有差異Azul Zulu 8zulu8.XX.X-ca-jdk8.0.XXX-win_x64.msi需要長期穩(wěn)定更新的場景版本號(hào)命名規(guī)則不同國內(nèi)廠商發(fā)行版各家自有命名國內(nèi)網(wǎng)絡(luò)環(huán)境、企業(yè)采購需確認(rèn)與目標(biāo)項(xiàng)目的兼容性選哪個(gè)我的經(jīng)驗(yàn)是**開發(fā)機(jī)優(yōu)先選帶 exe/msi 安裝器的版本省心服務(wù)器和需要頻繁切換版本的機(jī)器優(yōu)先選 zip 壓縮包版本可控。**壓縮包版本不寫注冊表、不碰系統(tǒng)目錄解壓即用刪掉就是卸載干凈這對需要多版本共存的機(jī)器來說是最優(yōu)解。至于從哪下載原則很簡單認(rèn)準(zhǔn)發(fā)行方的官方站點(diǎn)或者其官方代碼托管倉庫的發(fā)布頁。第三方下載站的安裝包我強(qiáng)烈不建議用一是版本可能是被改過的二是很多下載站會(huì)捆綁東西三是你無法驗(yàn)證文件完整性。這一點(diǎn)在給客戶裝環(huán)境時(shí)尤其重要出問題你沒法解釋。2.2 32 位還是 64 位這個(gè)問題比你想象的嚴(yán)重2024 年了還有人裝 32 位 JDK通常是因?yàn)榭戳艘黄甏眠h(yuǎn)的教程。判斷方法很簡單在 Windows 上打開設(shè)置 - 系統(tǒng) - 關(guān)于看系統(tǒng)類型這一行寫的是基于 x64 的處理器就裝 64 位寫的是基于 x86或者32 位操作系統(tǒng)才裝 32 位?，F(xiàn)在還在跑 32 位 Windows 的機(jī)器基本都是十幾年前的老設(shè)備或者某些工控機(jī)。為什么強(qiáng)調(diào)這個(gè)因?yàn)?32 位 JVM 的堆內(nèi)存上限受地址空間限制實(shí)際上你能給的最大堆通常在 1.5G 到 2G 之間再大就啟動(dòng)不了。而 64 位 JVM 只要物理內(nèi)存夠幾十 G 的堆都能給。如果你在一個(gè) 16G 內(nèi)存的機(jī)器上誤裝了 32 位 JDK然后按教程配了-Xmx4g結(jié)果就是 JVM 直接起不來報(bào)Could not reserve enough space for object heap新手很容易以為是內(nèi)存不夠其實(shí)是位數(shù)錯(cuò)了。確認(rèn)當(dāng)前已裝 JDK 位數(shù)的方法命令行執(zhí)行java -version如果輸出里有64-Bit Server VM就是 64 位只寫Client VM沒有 64-Bit 字樣那多半是 32 位。這是最快的判斷方式。2.3 校驗(yàn)文件完整性一個(gè)被忽略的好習(xí)慣從官網(wǎng)下載的文件如果網(wǎng)絡(luò)不穩(wěn)定有可能下載不完整裝到一半報(bào)錯(cuò)或者裝完了運(yùn)行異常。養(yǎng)成校驗(yàn)的習(xí)慣能省很多時(shí)間。發(fā)行方一般會(huì)提供 SHA256 校驗(yàn)值Windows 上用 PowerShell 一條命令就能算出本地文件的哈希Get-FileHash -Algorithm SHA256 C:\Users\你的用戶名\Downloads\jdk-8uXXX-windows-x64.exe把輸出的哈希值和官網(wǎng)公布的值比對一致就放心裝。不一致就重新下載。這一步大概花 10 秒但能擋掉一類莫名其妙的安裝失敗。提示如果官網(wǎng)只給了 MD5用Get-FileHash -Algorithm MD5也行。哈希值不區(qū)分大小寫比對時(shí)不用糾結(jié)字母大小寫。3. 安裝實(shí)操從雙擊安裝包到環(huán)境變量配好進(jìn)入正題。下面按安裝器版本這一條主線講因?yàn)樗婕安襟E最多坑也最集中講完再補(bǔ)壓縮包版本的做法。3.1 圖形化安裝每一步都在做什么雙擊安裝包第一個(gè)界面是歡迎頁直接下一步。第二個(gè)界面是安裝路徑默認(rèn)是C:\Program Files\Java\jdk1.8.0_XXX后面還有一步問你 JRE 裝哪里默認(rèn)是C:\Program Files\Java\jre1.8.0_XXX。路徑要不要改我的建議分兩種情況。如果你這輩子只打算在這臺(tái)機(jī)器上裝這一個(gè) JDK默認(rèn)路徑完全沒問題別折騰。如果你確定以后會(huì)有多個(gè) JDK 版本共存那從一開始就把安裝目錄規(guī)劃好比如統(tǒng)一放在C:\Java\下面每個(gè)版本一個(gè)子目錄C:\Java\jdk1.8.0_202 C:\Java\jdk-17.0.9 C:\Java\jdk-21.0.1這樣做的好處是所有 JDK 在同一層級(jí)切換版本時(shí)只需要改一個(gè)環(huán)境變量值不用去翻Program Files里那一堆名字相似的目錄。而且路徑里沒有空格寫腳本的時(shí)候不用處理引號(hào)轉(zhuǎn)義少一類奇怪的問題。安裝過程中的兩個(gè)小坑第一安裝器會(huì)順便裝一個(gè) JRE并且往系統(tǒng) Path 里塞一個(gè)C:\ProgramData\Oracle\Java\javapath的條目。這個(gè)目錄里放的是java.exe、javaw.exe、javac.exe的轉(zhuǎn)發(fā)程序它總是指向最后安裝的那個(gè) JRE。這就是很多人裝完 JDK8 又裝了 JDK17 之后java -version顯示的不是自己想要的那個(gè)版本的根源。記住這個(gè)條目后面排查要用。第二安裝路徑里絕對不要出現(xiàn)中文和空格之外的怪字符尤其不要放在桌面或者中文命名的文件夾下。JVM 在解析類路徑時(shí)對非 ASCII 字符的處理在 JDK8 上并不完美有些場景會(huì)出問題沒必要給自己找麻煩。安裝完成后安裝器會(huì)提示成功。但此時(shí)打開命令行執(zhí)行java -version可能會(huì)成功javac -version卻提示找不到命令因?yàn)榘惭b器配了 Path 但沒配 JAVA_HOME而且不同版本安裝器的行為不一致。所以下一步的環(huán)境變量配置必須自己動(dòng)手。3.2 JAVA_HOME、Path、CLASSPATH三個(gè)變量的分工這三個(gè)變量的關(guān)系用一個(gè)比喻就明白了。JAVA_HOME 是JDK 住在哪Path 是系統(tǒng)去哪兒找可執(zhí)行文件CLASSPATH 是java 命令去哪兒找要加載的類。很多人配錯(cuò)是因?yàn)榘?JAVA_HOME 和 Path 的職責(zé)搞混了。先說 JAVA_HOME。它的值是 JDK 的安裝根目錄不帶\bin變量名JAVA_HOME 變量值C:\Java\jdk1.8.0_202為什么要設(shè)這個(gè)變量因?yàn)榇罅康谌焦ぞ咭蕾囁麺aven、Gradle、Tomcat 的啟動(dòng)腳本、各種 IDE 的項(xiàng)目配置都會(huì)去讀 JAVA_HOME 來決定用哪個(gè) JDK。你如果不設(shè)這些工具要么報(bào)錯(cuò)要么用系統(tǒng)里第一個(gè)找到的 java結(jié)果不可控。再說 Path。Path 里要加的是 JDK 的 bin 目錄。這里有一個(gè)關(guān)鍵選擇**寫絕對路徑C:\Java\jdk1.8.0_202\bin還是寫%JAVA_HOME%\bin**我強(qiáng)烈建議后者。原因是切換 JDK 版本時(shí)你只需要改 JAVA_HOME 一個(gè)變量的值Path 不用動(dòng)。如果你寫的絕對路徑以后每換一次版本就得改一次 Path改漏了就會(huì)出現(xiàn)JAVA_HOME 是 17java -version 顯示 8這種詭異現(xiàn)象。Path 中新增%JAVA_HOME%\bin操作路徑右鍵此電腦→ 屬性 → 高級(jí)系統(tǒng)設(shè)置 → 環(huán)境變量。注意要區(qū)分用戶變量和系統(tǒng)變量。對于個(gè)人開發(fā)機(jī)配在用戶變量里就夠了改動(dòng)即時(shí)生效且不需要管理員權(quán)限如果是多人共用的服務(wù)器配在系統(tǒng)變量里這樣所有賬戶都能用。切換版本的靈活性上用戶變量更占優(yōu)勢因?yàn)槟憧梢越o不同用戶配不同版本。最后說 CLASSPATH。**我的建議是不要設(shè)或者只設(shè)一個(gè)點(diǎn)號(hào).。**網(wǎng)上大量老教程讓你設(shè).;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar這在 JDK8 上完全沒必要因?yàn)檫@兩個(gè) jar 里放的是老式的 Java 類庫現(xiàn)代 JDK 的類加載機(jī)制已經(jīng)不需要顯式指定。而如果你設(shè)錯(cuò)了 CLASSPATH比如丟了開頭的點(diǎn)號(hào)會(huì)導(dǎo)致java HelloWorld找不到當(dāng)前目錄的類報(bào)Could not find or load main class新手排查這個(gè)錯(cuò)誤能耗掉一下午。不設(shè) CLASSPATH 時(shí)JVM 默認(rèn)就是當(dāng)前目錄最省事。注意如果機(jī)器上已有 CLASSPATH 變量且里面還有別的內(nèi)容不要在原有內(nèi)容上亂加先備份一份值再改。刪掉別人配的東西可能導(dǎo)致其他軟件出問題。3.3 驗(yàn)證四條命令確認(rèn)裝對了環(huán)境變量改完必須重新打開一個(gè)新的命令行窗口因?yàn)橐呀?jīng)打開的窗口繼承的是舊的環(huán)境變量改了也不會(huì)生效。這是新手最常犯的錯(cuò)誤改完發(fā)現(xiàn)沒用以為是配置錯(cuò)了其實(shí)是窗口沒重開。新開一個(gè) cmd 或 PowerShell依次執(zhí)行java -version javac -version echo %JAVA_HOME% where java逐條解釋結(jié)果應(yīng)該是什么樣。java -version正常輸出類似java version 1.8.0_202 Java(TM) SE Runtime Environment (build 1.8.0_202-b08) Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)注意這里顯示的版本號(hào)是1.8.0_XXX而不是8.0.XXX這是 JDK 的歷史遺留命名兩者是同一個(gè)東西不要以為自己裝錯(cuò)了。第二行如果出現(xiàn)64-Bit說明位數(shù)正確。javac -version應(yīng)該輸出javac 1.8.0_202。如果這條報(bào)不是內(nèi)部或外部命令說明 Path 沒配好或者配的是 JRE 的路徑而不是 JDK 的路徑。JDK 的 bin 目錄里一定有javac.exe去目錄里看一眼就能確認(rèn)。echo %JAVA_HOME%應(yīng)該原樣打印你設(shè)的路徑。如果打印出%JAVA_HOME%本身說明變量沒設(shè)成功檢查是不是把變量設(shè)到了另一個(gè)作用域用戶變量和系統(tǒng)變量設(shè)混了。where java會(huì)列出系統(tǒng)里所有能找到的 java.exe按 Path 順序排列。**這條命令是排查版本沖突的利器。**正常情況下應(yīng)該優(yōu)先列出你配的C:\Java\jdk1.8.0_202\bin\java.exe。如果第一行是C:\ProgramData\Oracle\Java\javapath\java.exe或者C:\Windows\System32\java.exe那就是被搶了需要把 Path 里%JAVA_HOME%\bin的條目上移到這些條目之前。3.4 壓縮包版本的做法解壓即用如果你下載的是 zip 包很多發(fā)行版只提供這種流程更簡單但要更細(xì)心。解壓到一個(gè)沒有空格和中文的目錄比如C:\Java\jdk8u202注意解壓后的目錄結(jié)構(gòu)很多壓縮包解壓出來會(huì)多一層目錄比如jdk8u202-b08\jdk8u202-b08\bin這種情況下 JAVA_HOME 要指向真正含 bin 的那一層。然后配環(huán)境變量的步驟和上面完全一樣。區(qū)別在于壓縮包版本不在系統(tǒng)里注冊任何東西也不會(huì)有 javapath 這類干擾項(xiàng)所以where java通常非常干凈只有你自己配的那一個(gè)。對需要精細(xì)控制版本的場景來說這是優(yōu)點(diǎn)。卸載也很簡單把環(huán)境變量里的相關(guān)條目刪掉然后把目錄刪掉就完事了不留垃圾。相比之下安裝器版本卸載后可能殘留注冊表和 javapath 目錄還得手動(dòng)清理。提示解壓類 JDK 建議在目錄名里保留完整的版本號(hào)比如jdk8u202、jdk8u392這樣以后裝了多個(gè) 8 的小版本時(shí)一眼能分清哪個(gè)是哪個(gè)不用去翻 release 文件。4. 多版本共存讓 JDK8 和 JDK17 不打架這部分是很多人真正需要的。一臺(tái)機(jī)器上同時(shí)有 JDK8 和 JDK17怎么做到想用哪個(gè)用哪個(gè)而不是改一次環(huán)境變量重啟一次。4.1 不要直接改 Path改用切換策略最笨的辦法是用 JDK8 時(shí)把 Path 改成 8 的 bin用 JDK17 時(shí)改成 17 的 bin每次改完重啟命令行。能用但費(fèi)勁而且容易忘。更好的做法是分層第一層把每個(gè) JDK 的版本變量單獨(dú)定義好互不干擾JAVA8_HOME C:\Java\jdk1.8.0_202 JAVA17_HOME C:\Java\jdk-17.0.9 JAVA21_HOME C:\Java\jdk-21.0.1第二層定義一個(gè)總的 JAVA_HOME它的值引用上面某一個(gè)JAVA_HOME %JAVA8_HOME%第三層Path 里只寫%JAVA_HOME%\bin。這樣切換版本時(shí)你只需要把 JAVA_HOME 的值從%JAVA8_HOME%改成%JAVA17_HOME%全局就是一致的。改完之后新開窗口驗(yàn)證即可。這種做法的好處是所有依賴 JAVA_HOME 的工具M(jìn)aven、Gradle、IDE、Tomcat 腳本都會(huì)自動(dòng)跟著切不會(huì)出現(xiàn)命令行是 8IDE 里是 17這種分裂狀態(tài)。我見過太多項(xiàng)目因?yàn)?IDE 和命令行用了不同 JDK編譯出來的 class 版本對不上報(bào)Unsupported major.minor version 52.0或者61.0這類錯(cuò)誤只要版本統(tǒng)一就不會(huì)出現(xiàn)。4.2 用腳本做單次會(huì)話級(jí)切換上面改的是系統(tǒng)級(jí)變量影響所有新開的窗口。如果你只是臨時(shí)想用另一個(gè)版本跑一下不想改全局配置可以在腳本里做會(huì)話級(jí)覆蓋。寫一個(gè) bat 文件雙擊就直接進(jìn)入使用 JDK8 的命令行echo off set JAVA_HOMEC:\Java\jdk1.8.0_202 set PATH%JAVA_HOME%\bin;%PATH% echo JAVA_HOME set to %JAVA_HOME% java -version cmd /k這段腳本的邏輯很直白把 JAVA_HOME 臨時(shí)設(shè)置成 JDK8 的路徑然后把它的 bin 目錄拼到當(dāng)前 Path 的最前面這樣本次會(huì)話里java命令優(yōu)先找到的就是 JDK8。最后一句cmd /k保持窗口不關(guān)閉方便你繼續(xù)在里面敲命令。把這段保存成use-jdk8.bat放在桌面或者放一個(gè)專門的工具目錄里同理再做一份use-jdk17.bat。需要哪個(gè)版本就雙擊哪個(gè)互不影響也不污染系統(tǒng)環(huán)境。這個(gè)技巧我在處理跨版本兼容性驗(yàn)證時(shí)用得特別多比如要確認(rèn)這個(gè) API 在 JDK8 上能不能編譯通過直接開一個(gè) JDK8 會(huì)話編譯一遍再開一個(gè) JDK17 會(huì)話編譯一遍兩分鐘就能得出結(jié)論。PowerShell 用戶可以用這段來做永久設(shè)置需要管理員權(quán)限[Environment]::SetEnvironmentVariable(JAVA_HOME, C:\Java\jdk1.8.0_202, Machine)第三個(gè)參數(shù) Machine 表示系統(tǒng)變量換成 User 就是用戶變量。設(shè)置完同樣要新開窗口才生效。4.3 驗(yàn)證多版本切換是否成功切換之后不要只看java -version就完事把這三條都跑一遍命令期望結(jié)果說明echo %JAVA_HOME%指向當(dāng)前目標(biāo)版本目錄確認(rèn)變量本身生效where java第一行是目標(biāo)版本的 bin 下的 java.exe確認(rèn)沒有被其他路徑搶占javac -version與 java 版本一致確認(rèn)編譯器也是目標(biāo)版本不是殘留的舊版特別強(qiáng)調(diào)第三行。我遇到過一種情況java 命令已經(jīng)是 JDK17 了但 javac 還是 JDK8 的原因是某次操作在 Path 里額外加了一個(gè)絕對的 bin 路徑導(dǎo)致兩個(gè)版本混在一起。這種狀態(tài)下編譯出來的 class 是 52.0用 JDK17 的 java 運(yùn)行會(huì)直接報(bào)版本不支持的錯(cuò)。所以每次切換后三條一起驗(yàn)養(yǎng)成習(xí)慣。還有一個(gè)隱蔽的干擾源C:\Windows\System32\java.exe。某些軟件會(huì)在安裝時(shí)往這里放一個(gè) java.exe。系統(tǒng)目錄在 Path 里的優(yōu)先級(jí)通常很高所以偶爾會(huì)出現(xiàn)明明配了 JAVA_HOMEwhere java第一行卻是 System32 的情況。解決辦法是把%JAVA_HOME%\bin移到 Path 列表的最上方或者干脆把系統(tǒng)目錄里那個(gè) java.exe 重命名備份前提是確認(rèn)沒有別的軟件依賴它。5. 常見問題與排查技巧實(shí)錄下面這些是我在實(shí)際操作中反復(fù)遇到過的按癥狀—原因—處理的結(jié)構(gòu)整理你可以當(dāng)速查表用。5.1 命令行提示不是內(nèi)部或外部命令這是最高頻的問題。先按順序排除四個(gè)可能。第一命令行窗口沒有重新打開用的是改環(huán)境變量之前的老窗口。第二Path 里寫的是絕對路徑但路徑本身寫錯(cuò)了比如把jdk1.8.0_202寫成了jdk1.8.0_20。第三配置的是用戶變量但當(dāng)前命令行是以另一個(gè)用戶身份運(yùn)行的比如管理員權(quán)限的窗口對應(yīng)的是管理員賬戶的環(huán)境變量。第四裝的其實(shí)是 JREbin 目錄里根本沒有 javac.exe。排查順序建議先去文件資源管理器里打開你配的路徑確認(rèn)java.exe和javac.exe都在。在的話再看環(huán)境變量里 Path 的條目是否完整。都不行就重開窗口再試。這三步能解決 95% 的此類問題。5.2 java 版本和預(yù)期的對不上where java輸出多行第一行不是你配的那個(gè)就是被搶了。常見的搶占者有C:\ProgramData\Oracle\Java\javapath\Oracle 安裝器寫的、C:\Windows\System32\、其他軟件自帶的 JRE 目錄。處理方法是打開環(huán)境變量里 Path 的編輯界面從上往下看找到%JAVA_HOME%\bin這一條把它上移到所有其他 java 相關(guān)條目的前面。Windows 的 Path 是按順序查找的誰在前面用誰。如果 Path 太長看不到全貌可以點(diǎn)編輯文本按鈕切換到文本模式看清楚順序再調(diào)整。注意Path 編輯界面的編輯文本模式下每一行是一個(gè)路徑不要給路徑加引號(hào)也不要留空行。加引號(hào)會(huì)導(dǎo)致整個(gè)路徑失效這是個(gè)非常隱蔽的坑。5.3 中文亂碼怎么處理JDK8 在 Windows 上默認(rèn)編碼跟隨系統(tǒng)區(qū)域中文系統(tǒng)就是 GBK。如果你的程序讀寫的文件是 UTF-8 編碼就會(huì)亂碼。臨時(shí)解決辦法是在命令行先執(zhí)行chcp 65001把代碼頁切成 UTF-8再運(yùn)行程序。但這個(gè)只對當(dāng)前窗口有效而且某些老程序在 65001 代碼頁下會(huì)輸出異常。更穩(wěn)妥的做法是啟動(dòng)時(shí)顯式指定編碼java -Dfile.encodingUTF-8 -jar your-app.jar如果希望永久生效可以設(shè)一個(gè)環(huán)境變量JAVA_TOOL_OPTIONS值為-Dfile.encodingUTF-8。這個(gè)變量的好處是 JVM 啟動(dòng)時(shí)會(huì)自動(dòng)讀取不用每次改命令。缺點(diǎn)是它會(huì)在啟動(dòng)時(shí)打印一行Picked up JAVA_TOOL_OPTIONS提示看著有點(diǎn)煩但不影響使用。還有一個(gè)相關(guān)參數(shù)是-Dsun.jnu.encodingUTF-8它控制的是文件名的編碼。這兩個(gè)參數(shù)一起用時(shí)能覆蓋絕大多數(shù)中文亂碼場景。不過要注意JDK8 上改編碼不如 JDK9 之后干凈某些場景依然會(huì)跟隨系統(tǒng)所以最根本的辦法還是統(tǒng)一下項(xiàng)目里的文件編碼和運(yùn)行環(huán)境編碼。5.4 安裝包雙擊沒反應(yīng)或中途失敗這種現(xiàn)象在 Windows 11 上比以前多?？赡艿脑蛴袔讉€(gè)。一是安裝包被安全軟件攔截了去安全軟件的攔截記錄里找找看或者臨時(shí)關(guān)閉實(shí)時(shí)防護(hù)再裝。二是臨時(shí)目錄權(quán)限問題安裝器需要往%TEMP%寫文件如果那個(gè)目錄權(quán)限異常就會(huì)卡住可以用管理員身份運(yùn)行安裝包試試。三是下載的文件不完整回到第 2.3 節(jié)的哈希校驗(yàn)步驟驗(yàn)證一下。四是系統(tǒng)里的某個(gè)殘留服務(wù)占用了文件重啟后重裝通常能解決。另外還有一種情況安裝到一半報(bào)錯(cuò)誤 1723或類似的 MSI 錯(cuò)誤多半是 Windows Installer 服務(wù)狀態(tài)異常。這種時(shí)候重啟電腦再裝或者用msiexec /unregister和msiexec /regserver重新注冊一下服務(wù)成功率很高。5.5 裝完了但程序起不來幾個(gè)方向如果java -version一切正常但你的 jar 或者 Tomcat 起不來問題通常不在 JDK 安裝本身而在下面幾個(gè)方向。檢查啟動(dòng)腳本里有沒有硬編碼的 JAVA_HOME 路徑指向一個(gè)不存在的目錄這在遷移或者拷貝項(xiàng)目時(shí)極其常見。檢查有沒有-Xmx之類的內(nèi)存參數(shù)超過了物理內(nèi)存減去系統(tǒng)占用后的可用值。檢查端口是否被占用Web 應(yīng)用常見的 8080、8005 沖突會(huì)直接導(dǎo)致啟動(dòng)失敗。還有一個(gè)容易被忽略的點(diǎn)JDK8 的 Metaspace 默認(rèn)沒有上限如果某個(gè)應(yīng)用瘋狂生成動(dòng)態(tài)類比如大量使用反射、字節(jié)碼增強(qiáng)的框架會(huì)出現(xiàn)元空間持續(xù)增長直到耗盡機(jī)器內(nèi)存的情況。這類問題的表現(xiàn)是程序運(yùn)行一段時(shí)間后響應(yīng)變慢、機(jī)器內(nèi)存吃緊日志里不一定有明顯報(bào)錯(cuò)。處理方式是加參數(shù)限制-XX:MaxMetaspaceSize256m然后觀察是否穩(wěn)定。提示排查 JVM 層面的問題jps -lvm能列出當(dāng)前機(jī)器上所有 Java 進(jìn)程及其啟動(dòng)參數(shù)jstack pid能打印線程棧jmap -heap pid能看堆內(nèi)存分布。這三個(gè)命令都在 JDK 的 bin 目錄里前提是你裝的是 JDK 而不是 JRE。6. 裝完之后值得馬上做的幾件事環(huán)境裝好只是起點(diǎn)下面這幾件事做了能讓你后面少走很多彎路。第一件寫一個(gè)最小的 Hello World 跑通全流程。不要覺得多余這能一次性驗(yàn)證 javac 和 java 兩個(gè)命令、編碼、類路徑三個(gè)環(huán)節(jié)。新建一個(gè)HelloJDK8.java內(nèi)容如下public class HelloJDK8 { public static void main(String[] args) { System.out.println(JDK version: System.getProperty(java.version)); System.out.println(Java home: System.getProperty(java.home)); } }在文件所在目錄執(zhí)行javac HelloJDK8.java java HelloJDK8java.home輸出的路徑會(huì)告訴你當(dāng)前實(shí)際用的是哪個(gè) JDK 的運(yùn)行環(huán)境。這個(gè)信息在多版本環(huán)境下特別有用比java -version更準(zhǔn)確因?yàn)樗蛴〉氖?JVM 自己認(rèn)定的主目錄。第二件把常用的構(gòu)建工具一并配好。如果項(xiàng)目用 Maven注意 Maven 自己也會(huì)讀 JAVA_HOME所以只要 JDK 切對了Maven 通常不用額外配置。但如果你需要針對某個(gè)項(xiàng)目固定 JDK 版本可以在maven-compiler-plugin里顯式聲明 source 和 target 都為 1.8這樣即使有人用 JDK17 跑構(gòu)建編譯出來的也是 8 的目標(biāo)版本。當(dāng)然這只解決編譯層面運(yùn)行時(shí)還是得用 8。第三件給環(huán)境留一份記錄。在C:\Java\下面放一個(gè)README.txt寫清楚每個(gè)目錄對應(yīng)哪個(gè)版本、什么時(shí)候裝的、用在哪個(gè)項(xiàng)目上。這個(gè)習(xí)慣聽起來有點(diǎn)多余但當(dāng)你半年后接手一個(gè)沒人維護(hù)的機(jī)器看到這份記錄會(huì)非常慶幸。我自己維護(hù)的幾臺(tái)構(gòu)建機(jī)上都放了這個(gè)文件同事接手時(shí)能省掉大量摸索時(shí)間。第四件考慮把 JAVA_HOME 和 Path 的配置導(dǎo)出備份。用setx命令可以或者直接截圖存一份。Windows 的環(huán)境變量界面看起來能看全但實(shí)際上長 Path 會(huì)被折疊出問題時(shí)不容易發(fā)現(xiàn)。導(dǎo)出一份文本備份出問題能快速對照。最后再說個(gè)實(shí)際體會(huì)。JDK8 在 Windows 上的安裝本身并不復(fù)雜復(fù)雜的是它經(jīng)常出現(xiàn)在一個(gè)已經(jīng)有其他 JDK 的機(jī)器上而大部分教程默認(rèn)你是從零開始的。所以我在任何一臺(tái)新機(jī)器上裝 JDK 之前都會(huì)先花兩分鐘執(zhí)行where java、java -version、echo %JAVA_HOME%三條命令摸清現(xiàn)狀再動(dòng)手。這個(gè)兩分鐘的投入比事后排查版本沖突省下的時(shí)間多得多。另外如果你是要給一臺(tái)長期運(yùn)行的服務(wù)器裝環(huán)境盡量選壓縮包版本放在統(tǒng)一的目錄下別用安裝器因?yàn)榘惭b器版本在多用戶、多版本場景下帶來的隱性耦合太多卸載時(shí)還可能留下 javapath 那種干擾項(xiàng)后續(xù)維護(hù)的人會(huì)罵人。這些都是踩過坑之后才明白的寫下來給后面的人省點(diǎn)事。