WebLogic 部署報錯「Unsupported major.minor version 51.0」完整解決方案

WebLogic 部署報錯「Unsupported major.minor version 51.0」完整解決方案

此錯誤經典且高發，本質是 編譯版本與執行版本不匹配。本文提供從原因分析到 Eclipse/Maven 多層面配置修正的完整指南。

一、錯誤本質與版本對照表

錯誤訊息：Unsupported major.minor version 51.0 → Class 檔案為 JDK 1.7 編譯，但執行環境為 JDK 1.6 或更低。

二、典型場景分析

場景：開發環境 Eclipse 使用 JDK 1.7
      生產環境 WebLogic 12c (12.1.3) 內建 JDK 1.6
      
結果：Eclipse 編譯產出 51.0 版本 Class
      WebLogic 1.6 JVM 無法載入 → 拋出版本不支援異常

三、Eclipse 端完整修正步驟（降級至 JDK 1.6）

步驟 1：修改 Installed JREs

1. Window → Preferences → Java → Installed JREs
2. 點擊 Add → Standard VM → Next
3. JRE home：選擇 JDK 1.6 安裝目錄（如 C:\Java\jdk1.6.0_45）
4. 勾選該 JRE 為預設

步驟 2：修改 Compiler Compliance Level

1. Window → Preferences → Java → Compiler
2. Compiler compliance level：1.6
3. 勾選 Use default compliance settings
4. Apply → Yes（重新建構）

步驟 3：修改專案專屬 Compiler 設定

1. 專案右鍵 → Properties → Java Compiler
2. 勾選 Enable project specific settings
3. Compiler compliance level：1.6
4. Apply → OK

步驟 4：修改 Project Facets Java 版本

1. 專案右鍵 → Properties → Project Facets
2. Java 版本下拉選單選擇 1.6
3. Apply → OK

步驟 5：修正 Build Path 中的 JRE System Library

1. 專案右鍵 → Properties → Java Build Path → Libraries
2. 移除現有的 JRE System Library [jdk1.7]
3. Add Library → JRE System Library → Workspace default JRE (jdk1.6)

四、Maven 編譯插件配置（關鍵：覆蓋 IDE 設定）

即使 Eclipse 設定正確，Maven 編譯若未指定版本，仍會使用預設 JDK 版本編譯。

<!-- pom.xml -->
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.6</source>
                <target>1.6</target>
                <encoding>UTF-8</encoding>
                <!-- 強制使用指定 JDK 編譯（可選） -->
                <!-- <executable>C:/Java/jdk1.6.0_45/bin/javac</executable> -->
            </configuration>
        </plugin>
    </plugins>
</build>

驗證命令：

mvn clean compile
# 檢查輸出
[INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ project --
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 152 source files to target/classes
# 無「無效的目標版本」錯誤即成功

五、替代方案：升級 WebLogic JDK（推薦長期方案）

若專案需使用 JDK 1.7+ 特性（try-with-resources、Diamond Operator 等），建議升級 WebLogic JDK：

1. 下載對應 WebLogic 版本支援的 JDK 1.7/1.8
2. 修改 setDomainEnv.sh/.cmd：

# Linux/Unix
JAVA_HOME="/opt/java/jdk1.8.0_202"
export JAVA_HOME

# Windows
set JAVA_HOME=C:\Java\jdk1.8.0_202

3. 重啟 WebLogic Admin Server 與 Managed Servers
4. 驗證：java -version 在 WebLogic 啟動日誌中顯示新版本

注意：WebLogic 12.1.3 官方支援 JDK 1.7，12.2.1+ 支援 JDK 1.8。升級前必須確認版本相容性矩陣。

六、常見遺漏檢查清單

□ 1. Eclipse Installed JREs → JDK 1.6
□ 2. Compiler Compliance Level → 1.6 (全域 + 專案)
□ 3. Project Facets → Java 1.6
□ 4. Build Path Libraries → JRE System Library 指向 1.6
□ 5. pom.xml maven-compiler-plugin → source/target 1.6
□ 6. 執行 mvn clean compile 驗證無版本錯誤
□ 7. 部署前確認 target/classes 內 Class 版本
    # 使用 javap 驗證
    javap -verbose target/classes/com/example/MyClass.class | grep "major version"
    # 應輸出 major version: 50 (JDK 1.6)
□ 8. WebLogic 啟動日誌確認 JAVA_HOME 指向正確 JDK

七、原理補充：Class 文件版本檢查機制

// Class 文件頭部結構
CA FE BA BE  // Magic Number
00 00 00 33  // Minor Version: 0, Major Version: 51 (JDK 1.7)

// JVM 載入時檢查邏輯 (簡化)
if (classFile.majorVersion > JVM.supportedMajorVersion) {
    throw new UnsupportedClassVersionError(
        "Unsupported major.minor version " + classFile.majorVersion);
}

徹底解決版本不匹配的核心在於：統一 編譯環境、構建工具、執行環境 三端的 JDK 版本。短期可通過降級編譯版本快速修復，長期建議統一升級至 JDK 1.8+ 並確保 WebLogic 版本相容，避免維護雙版本配置的持續成本。