Eclipse 啟動報「Incompatible JVM」完美解決：JDK 路徑優先級與 oracle 衝突排查

安裝 Oracle Client 後 Eclipse 無法啟動，彈窗報錯：

Incompatible JVM
Version 1.3.1_01 of the JVM is not suitable for this product. Version 1.4.1 or greater is required.

或

Version 1.4.1_02 of the JVM is not suitable for this product. Version 1.5 or greater is required.

根因分析

1. 系統 PATH 環境變量中，Oracle 安裝目錄（含舊版 jre/bin）排在 JDK 之前。 Eclipse 啟動器按 PATH 順序搜尋 javaw.exe，優先找到 Oracle 自帶的舊版 JVM（通常 1.3/1.4），版本過低導致啟動失敗。
2. Eclipse 自身不攜帶 JVM，完全依賴系統註冊表或 PATH 尋找。

解決方案（按推薦順序）

方案一：調整 PATH 環境變量順序（最徹底，一勞永逸）

1. Win + S 搜索「編輯系統環境變量」→ 環境變量。
2. 在「系統變量」區找到 Path，編輯。
3. 將 JDK 安裝目錄下的 bin 目錄（如 C:\Program Files\Java\jdk-21\bin）移動到 Oracle 路徑之前。
4. 確認 JAVA_HOME 指向正確 JDK 根目錄（非 JRE）。
5. 重啟命令行驗證：java -version 應顯示目標版本。

方案二：修改 eclipse.ini 顯式指定 -vm 參數（最精準，不影響其他程式）

在 eclipse.ini 文件第一行添加：

-vm
C:/Program Files/Java/jdk-21/bin/javaw.exe

關鍵規則：

• -vm 必須獨佔一行，其路徑在下一行。
• 路徑指向 javaw.exe（GUI 程序），而非 java.exe（控制台程序）。
• 路徑使用正斜槓 / 或雙反斜槓 \\，避免轉義問題。
• -vm 必須放在 -vmargs 之前。

方案三：複製/刪除 Oracle 目錄下的 java.exe（不推薦，易被修復覆蓋）

重命名 %ORACLE_HOME%\bin\java.exe 為 java.exe.bak，強制系統跳過。但 Oracle 打補丁/升級會自動恢復，治標不治本。

驗證與防患

• 啟動 Eclipse → Help → About Eclipse → Installation Details → Configuration，搜索 java.vm.version 確認運行版本。
• 安裝新 JDK 後，同步更新 JAVA_HOME、Path、eclipse.ini -vm 三處。
• 團隊統一使用 SDKMAN! 或 jabba 管理 JDK 版本，避免「在我機器上能跑」的環境差異。

延伸閱讀： Eclipse 2024-09 起要求 JDK 17+ 運行平台，但可編譯目標版本為 8/11/17/21。生產項目建議配置 Compiler compliance level 與目標 JDK 一致，並啟用 --release 標識確保 API 兼容性。