在Equinox中集成Hibernate-OSGI时EntityManagerFactory为空问题

我之前在Equinox环境下做Hibernate OSGi集成时也碰到过类似的EntityManagerFactory为null的问题，结合你的场景，给你几个实用的排查方向：

1. 检查OSGi插件的依赖与打包配置 #

首先确认你的my.app.hibernate.osgi插件的MANIFEST.MF配置是否正确：

• 导入包声明：必须显式导入Hibernate和JPA相关的核心包，比如javax.persistence.*、org.hibernate.*、org.jboss.logging.*等；另外建议添加动态导入配置DynamicImport-Package: *（或者更精准的包范围），因为Hibernate会动态加载一些扩展类，OSGi默认不会自动解析这类依赖。
• Bundle类路径：确保你列出的所有JAR都在Bundle-ClassPath中声明，比如：

Bundle-ClassPath: .,
 antlr-2.7.7.jar,
 byte-buddy-1.6.14.jar,
 classmate-1.3.0.jar,
 dom4j-1.6.1.jar,
 hibernate-commons-annotations-5.0.1.Final.jar,
 hibernate-core-5.2.16.Final.jar,
 hibernate-jpa-2.1-api-1.0.0.Final.jar,
 hibernate-osgi-5.2.16.Final.jar,
 jandex-2.0.3.Final.jar,
 javassist-3.22.0-GA.jar,
 javax.interceptor-api-1.2.jar,
 jboss-logging-3.3.1.Final.jar,
 jboss-transaction-api-1.2.jar

2. 验证Hibernate配置文件的OSGi适配性 #

如果使用persistence.xml（放在META-INF目录下），注意以下几点：

• 明确指定Provider：<provider>org.hibernate.jpa.HibernatePersistenceProvider</provider>
• 数据源配置要适配OSGi环境：尽量通过OSGi的DataSource服务获取连接，而不是直接用JDBC URL硬编码；如果必须用JDBC驱动，要确保驱动类所在的JAR已嵌入插件或作为独立OSGi bundle安装。
• 实体类声明要完整：检查<class>标签是否包含了所有需要映射的实体类，且这些类所在的包能被Hibernate访问到（比如插件已导出该包，或实体类在插件内部）。

3. 调整EntityManagerFactory的获取方式 #

在OSGi环境下，不能像Java SE那样直接调用Persistence.createEntityManagerFactory()，要通过OSGi服务机制获取：

// 获取当前插件的BundleContext
BundleContext bundleContext = FrameworkUtil.getBundle(YourClass.class).getBundleContext();
// 获取Hibernate PersistenceProvider服务
ServiceReference<PersistenceProvider> providerRef = bundleContext.getServiceReference(PersistenceProvider.class);
PersistenceProvider hibernateProvider = bundleContext.getService(providerRef);
// 创建EntityManagerFactory
EntityManagerFactory emf = hibernateProvider.createEntityManagerFactory("你的持久化单元名称", null);

另外，也可以借助org.hibernate.osgi.HibernateBundleActivator来初始化Hibernate，它会自动注册相关服务到OSGi容器中。

4. 查看调试日志定位细节错误 #

打开Equinox的调试日志，添加以下配置到config.ini中，获取更详细的Hibernate和OSGi日志：

org.osgi.service.log.admin.loglevel=DEBUG
jboss.logging.level=DEBUG

日志里通常会暴露类找不到、依赖缺失、配置文件解析失败等问题，这些都是导致EntityManagerFactory初始化失败的常见原因。

5. 确认版本兼容性 #

你使用的hibernate-osgi-5.2.16.Final要和其他Hibernate组件版本保持一致（比如hibernate-core、hibernate-commons-annotations都是5.2.x系列）；同时尽量使用较新的Equinox版本（比如4.10及以上），避免OSGi规范兼容问题。

内容的提问来源于stack exchange，提问作者Zibus69