Eclipse 啟動報錯「Failed to load the JNI shared library jvm.dll」根因與一鍵修復

Eclipse 啟動報錯「Failed to load the JNI shared library jvm.dll」根因與一鍵修復

經典報錯彈窗：

核心根因：JDK 與 Eclipse 位數不匹配

• 32 位 Eclipse 必須配合 32 位 JDK/JRE。
• 64 位 Eclipse 必須配合 64 位 JDK/JRE。
• 混用（如 64 位 Eclipse + 32 位 JDK）會導致 Eclipse 啟動器找不到匹配位數的 jvm.dll，拋出 UnsatisfiedLinkError。

快速排查步驟

1. 查看 Eclipse 位數：Help → About Eclipse → Installation Details → Configuration，搜索 osgi.arch（x86=32位, x86_64=64位）。
2. 查看 JDK 位數：命令行執行 java -version，輸出含 64-Bit Server VM 即 64 位，否則 32 位。
3. 對齊位數：下載對應位數的 JDK 或 Eclipse，重新安裝/解壓。

進階：通過 eclipse.ini 顯式指定 JVM（推薦）

在 eclipse.ini 首行添加 -vm 參數，強制綁定特定 JDK，避免 PATH 環境變量順序導致的誤綁定：

-vm
C:/Program Files/Java/jdk1.8.0_202/bin/javaw.exe
-vmargs
-Dosgi.requiredJavaVersion=1.8
-Xms256m
-Xmx1024m
...

• -vm 後跟 javaw.exe 絕對路徑（不要用 java.exe，否則會有控制台窗口）。
• -vm 必須在 -vmargs 之前，單獨佔一行。

常見誤區

• ❌ 只安裝 JRE 不安裝 JDK → Eclipse 需要 JDK 編譯 JSP/Annotation Processing，請安裝完整 JDK。
• ❌ 修改系統 PATH → 影響其他軟件，不如 eclipse.ini 精準。
• ❌ 以管理員身份運行 Eclipse → 權限過高，工作空間文件所有權變更導致後續非管理員啟動失敗。

一鍵驗證工具

作者提供一個小工具（需管理員權限運行）可自動檢測當前環境 JDK/Eclipse 位數匹配情況：
下載鏈接（密碼: 1d39）