Java UnsupportedClassVersionError 52.0：JDK 版本不匹配排查全流程

錯誤核心

UnsupportedClassVersionError: ... Unsupported major.minor version 52.0

52.0 = Java 8 編譯的 class 檔，運行環境為 Java 7 或更低。

版本對照表

排查清單

1. 確認運行時 JDK：java -version 輸出必須 ≥ 1.8.0。
2. 確認編譯目標：Maven maven-compiler-plugin 設定 <source>1.8</source><target>1.8</target>；Eclipse 專案右鍵 Properties → Java Compiler → Compiler compliance level 1.8。
3. 檢查依賴庫：引入的第三方 JAR 若為 Java 8 編譯，運行時也需 Java 8+。錯誤堆疊指向 org.apdplat.word.analysis.TextSimilarity，確認該庫版本兼容性。
4. 環境變數：JAVA_HOME、PATH 指向 JDK 8+，無舊版 JRE 搶先載入。
5. Eclipse 版本：Eclipse 4.4 (Luna) 起完整支援 Java 8；舊版需更新或安裝 Babel Language Pack。

解決步驟

1. 安裝 JDK 17/21（LTS 推薦）。
2. 更新 Eclipse 至 2023-09+ 或改用 IntelliJ IDEA/VS Code。
3. 專案編譯目標設為 1.8（或更高），Maven 同步。
4. 清理專案 mvn clean install / Eclipse Clean Project。