Hibernate依賴包全解析：核心必備、連接池選擇、可選擴展包一覽

核心必備包（缺一不可）

連接池：四大選擇 + 容器原生

Hibernate不內置連接池，需顯式配置hibernate.connection.provider_class：

警告：在Java EE/Jakarta EE容器（WildFly、TomEE、WebLogic）中使用Hibernate，**必須**配置JNDI DataSource，禁用應用級連接池，否則@Transactional、EJB CMT將失效。

可選擴展包：按需引入

避坑指南：傳遞依賴衝突排查

1. 版本鎖定：使用Maven BOM（org.hibernate:hibernate-bom、org.springframework.boot:spring-boot-dependencies）統一版本
2. 排除傳遞：mvn dependency:tree定位衝突，<exclusion>排除舊版（如dom4j:dom4j:1.6 vs org.dom4j:dom4j:2.x）
3. 模塊化注意：Java 9+模塊系統下，jakarta.persistence等API包需--add-modules或Automatic-Module-Name
4. ClassLoader隔離：OSGi/Karaf/WildFly模塊環境下，Hibernate類加載器需能見應用實體類，配置hibernate.classloading.use_current_tccl_as_parent

最小依賴示例

<dependencies>
    <!-- 核心 -->
    <dependency>
        <groupId>org.hibernate.orm</groupId>
        <artifactId>hibernate-core</artifactId>
        <version>6.2.12.Final</version>
    </dependency>
    <!-- 連接池 -->
    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP</artifactId>
        <version>5.0.1</version>
    </dependency>
    <!-- 日誌 -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.4.14</version>
    </dependency>
    <!-- 驗證（可選） -->
    <dependency>
        <groupId>org.hibernate.validator</groupId>
        <artifactId>hibernate-validator</artifactId>
        <version>8.0.1.Final</version>
    </dependency>
</dependencies>

總結

Hibernate依賴管理的核心原則：核心包鎖定BOM版本、連接池首選HikariCP、日誌統一SLF4J+Logback、容器環境強制JNDI DataSource、擴展功能按需引入、定期dependency:tree清理傳遞衝突。理解每個JAR的具體職責，能在升級遷移、排查ClassNotFound/LinkageError、優化啟動性能時游刃有餘。

1. 上一篇文章： JCreator開發技巧三則：空項目管理、JDK文檔集成、Applet網頁預覽
2. 下一篇文章： 邁向Java高手的25個里程碑：從核心基礎到架構視野

Java 程式設計入門

以 Flash Remoting 強化 J2EE 表示層：富客戶端架構新選擇

動機：J2EE 表示層的兩難 JSP/HTML：部署輕鬆、

Java 多態深度解析：實現原理、五大陷阱與最佳實踐

多態實現原理：動態綁定 (Late Binding) Jav

J2ME 平台架構與元件深度解析：從 KVM 到 MIDlet 的完整應用開發指南

前言 J2ME 將 Java 網路中心、平台無關特性移植至資

Swing 動態加載磁盤文件到 JTable：JProgressBar 異步加載與隱藏文件標記

需求場景 模擬作業系統打開文件夾：用戶選擇目錄 → 進度條滾