解決 UnsupportedClassVersionError：JDK 版本不匹配排查指南

異常現象

java.lang.UnsupportedClassVersionError: Unsupported major.minor version

根因分析

異常字面意思：JVM 嘗試讀取類文件，發現其 major.minor version（類文件版本號）高於當前 JVM 支持的最高版本。

• 類文件由高版本 JDK 編譯（如 JDK 1.8 → version 52.0）
• 運行環境為低版本 JVM（如 JDK 1.7 → 僅支援至 51.0）

常見場景

1. 引入第三方庫（如 Spring Boot 2.x、Jetty 9.4+）要求 JDK 8+，但生產/開發環境仍跑 JDK 7。
2. Eclipse 預設 Compiler compliance level 為 1.7，導致編譯產出低版本類，但依賴庫已是高版本。

解決方案

方案一：升級 JDK（推薦）

• 安裝 JDK 8 / 11 / 17 (LTS)
• Eclipse 安裝 Java 8 Support for Eclipse Kepler/SR2 外掛（或直接換用支援新版 JDK 的 IDEA）
• 專案 Java Compiler 設為 1.8，Project Facets Java 版本改為 1.8

方案二：降級依賴（不推薦）

強制使用舊版庫（如 Spring Boot 1.5.x），但將失去新特性、安全補丁與長期支援。

版本對照表

可用 javap -verbose ClassName | findstr "major" 查看類文件版本。

最佳實踐

1. 統一開發、構建、部署環境 JDK 版本。
2. Maven/Gradle 明確聲明 source/target 或 release 參數。
3. CI 流程加入 java -version 與 javap 校驗步驟。

參考鏈接：Eclipse 安裝 JDK 8 外掛教程

版本不匹配是 Java 遷移期最常見的坑，升級 JDK 通常是最乾淨的解法。