徹底解決 Java「Unsupported major.minor version 49.0」版本衝突問題

錯誤本質：版本不相容

Unsupported major.minor version 49.0 錯誤的核心原因是：JDK 1.5 編譯的類別檔（版本 49.0）無法在 JVM 1.4 或更低版本執行。Java 類別檔開頭的 major.minor version 標識了編譯版本，JVM 只能載入版本號在其支援範圍內的類別檔。

major.minor version 藏身於何處？

類別檔第 5-8 位元組儲存 minor_version 與 major_version。以 JDK 1.5 編譯的 HelloWorld.class 為例，十六進位 0x0031 轉十進位為 49，故版本為 49.0。各 JDK 版本對應表：

• JDK 1.1 → 45.3
• JDK 1.2 → 46.0（-target 1.2）
• JDK 1.3 → 47.0（-target 1.3）
• JDK 1.4 → 48.0（-target 1.4）
• JDK 1.5 → 49.0
• JDK 1.6 → 50.0
• JDK 1.7 → 51.0
• JDK 1.8 → 52.0

三種查看類別版本的方法

1. Eclipse：3.3+ 版本開啟無原始碼類別時顯示版本資訊
2. javap -verbose：指令列直接輸出 major/minor version
3. MANIFEST.MF：JAR 包中 META-INF/MANIFEST.MF 的 Build-Jdk 或 Created-By 欄位

最可靠的是 javap -verbose 直接檢視位元碼，不受封裝後修改影響。

解決方案總覽

方案一：編譯器指定目標版本（推薦）

繼續使用高版本 JDK，編譯時加入參數：

javac -target 1.4 -source 1.4 YourClass.java

Ant 建構：

<javac target="1.4" source="1.4" ... />

Eclipse：專案屬性 → Java Compiler → 設定 Compiler compliance level、Generated class files compatibility、Source compatibility。

方案二：位元碼轉換工具 Retrotranslator

若程式碼使用了 JDK 1.5+ 新特性（泛型、自動裝箱、枚舉等），無法用 -source 1.4 編譯。此時可用 Retrotranslator 將已編譯的 1.5 位元碼轉為 1.4 相容版本，保留新特性語法優勢。

方案三：統一執行環境 JDK 版本

確認目標 JVM 版本（java -version 或 System.getProperty("java.class.version")），確保編譯目標版本不超過執行環境支援上限。

實戰案例：Tomcat JSP 編譯踩坑

將 JDK 1.5 環境下安裝的 Tomcat 整個目錄複製到 JDK 1.4 機器，JSP 編譯報 49.0 錯誤。原因：%TOMCAT_HOME%\common\lib\tools.jar 是安裝時從 JDK 1.5 複製來的，JSP 編譯器用的是 1.4 JVM 載入 49.0 版本的 tools.jar。解決：換上 JDK 1.4 的 tools.jar。

版本對應快速查核表

總結

major.minor 版本機制如同 32 位程式無法在 16 位系統執行。開發前確認目標 JVM 版本、善用 -target/-source 參數或 Retrotranslator，即可從根源避免版本衝突。