Hibernate 多模組專案配置避坑指南：cfg.xml 衝突與 SessionFactory 隔離

問題現場

同一應用伺服器部署多個 Web 模組（如 bbs.war、blog.war），皆使用 Hibernate 且預設配置檔命名為 hibernate.cfg.xml。部署順序不同導致：

• 先部署 bbs.war → 正常
• 先部署 blog.war → bbs 僅能讀取共用的在線用戶表，其餘映射（Forum.cfg.xml、Thread.cfg.xml）失效

根因分析

Hibernate 預設透過 Configuration().configure() 載入類路徑根目錄下的 hibernate.cfg.xml。多模組共用類加載器（如 Tomcat 共用 lib）時，先載入者勝出，後續模組的同名配置被忽略，導致映射檔未註冊。

三種解決方案對比

最佳實踐：模組專屬配置 + Spring 整合

1. 命名規範

src/main/resources/
├── hibernate-bbs.cfg.xml
├── hibernate-blog.cfg.xml
└── hibernate-common.cfg.xml  

2. Spring 註解配置範例

@Configuration
@PropertySource("classpath:hibernate-bbs.properties")
public class BbsHibernateConfig {

    @Bean
    public LocalSessionFactoryBean sessionFactory(DataSource dataSource) {
        LocalSessionFactoryBean sf = new LocalSessionFactoryBean();
        sf.setDataSource(dataSource);
        sf.setConfigLocation(new ClassPathResource("hibernate-bbs.cfg.xml"));
        sf.setPackagesToScan("com.example.bbs.entity");
        sf.setHibernateProperties(hibernateProps());
        return sf;
    }
}

3. 共用屬性外部化

hibernate-common.cfg.xml 僅保留映射引用：

<hibernate-configuration>
  <session-factory>
    <mapping resource="com/example/bbs/entity/Forum.hbm.xml"/>
    <mapping resource="com/example/bbs/entity/Thread.hbm.xml"/>
  </session-factory>
</hibernate-configuration>

資料庫連線、方言、連接池等放入 .properties，透過 Spring @PropertySource 注入，實現配置與映射分離。

進階：JPA 時代的替代方案

若專案已遷移至 JPA/Hibernate 5+，建議改用 persistence.xml + LocalContainerEntityManagerFactoryBean，天然支援多持久化單元隔離：

<persistence-unit name="bbsPU" transaction-type="JTA">
  <jta-data-source>java:/jdbc/bbsDS</jta-data-source>
  <properties>
    <property name="hibernate.hbm2ddl.auto" value="update"/>
  </properties>
</persistence-unit>

總結

• 禁用預設 hibernate.cfg.xml 作為多模組專案的配置入口。
• 採用模組專屬配置檔 + 明確指定路徑載入。
• 配置屬性外部化至 .properties，映射檔保留於 XML，便於 Spring/容器統一管理。
• 新專案優先考慮 JPA 標準化配置，減少 Hibernate 原生 API 依賴。