Hibernate 5.2 最小依賴 JAR 清單：required 目錄全包 + MySQL 驅動

Hibernate 5.2 最小依賴 JAR 清單：required 目錄全包 + MySQL 驅動

Hibernate 5.2 官方發布包結構清晰，required 目錄包含核心運行所需的所有 JAR。本文確認最小依賴組合，避免遺漏或多餘引入。

最小依賴組合

Hibernate 5.2 最小依賴 = 
  { lib/required 目錄下所有 JAR } 
  + { mysql-connector-java-bin.jar (或對應資料庫驅動) }

required 目錄典型內容（Hibernate 5.2.x）

注意：具體檔名隨小版本變動，請以官方發布包 lib/required 實際內容為準。

資料庫驅動（必須額外加入）

可選依賴目錄說明

Maven 依賴最佳實踐

<dependencies>
    <!-- 核心：遞移自動引入 required 所有依賴 -->
    <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-core</artifactId>
        <version>5.2.18.Final</version>
    </dependency>
    
    <!-- 資料庫驅動（必須額外宣告） -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.28</version>
    </dependency>
    
    <!-- 連接池（生產環境必備，推薦 HikariCP） -->
    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP</artifactId>
        <version>4.0.3</version>
    </dependency>
</dependencies>

常見遺漏導致的啟動錯誤

• NoClassDefFoundError: org/javassist/ClassPool → 缺少 javassist（required 已含，檢查版本衝突）
• NoClassDefFoundError: net/bytebuddy/ByteBuddy → 缺少 byte-buddy（Hibernate 5.2+ 必須）
• Unable to load class [com.mysql.jdbc.Driver] → 缺少 MySQL 驅動
• NoClassDefFoundError: javax/validation/Validation → 缺少 validation-api

總結

Hibernate 5.2 依賴管理原則：信任 required 目錄全量引入，補上資料庫驅動，按功能從 optional 目錄按需添加。Maven 專案直接依賴 hibernate-core 即可自動解析 required 遞移依賴，僅需額外宣告驅動與連接池。版本升級時關注 byte-buddy、jakarta.persistence 等新增依賴的版本相容性。