Spring Boot 3升级遇EclipseLink与Bitronix兼容问题求解决方案

背景 #

• 已完成WebSphere到Spring Boot云环境的迁移，过程顺利
• 消息服务从IBM MQ迁移至Kafka后，无需两阶段提交，数据库与消息操作可通过单次数据库提交完成
• 当前计划升级至Spring Boot 3 + Tomcat 10（基于Jakarta命名空间）

核心冲突：EclipseLink与Bitronix的兼容问题 #

EclipseLink 3.0已适配Jakarta命名空间，但原有依赖的Bitronix事务管理器不支持Jakarta，导致手动绑定事务控制器的代码逻辑失效：

final SessionManager manager = org.eclipse.persistence.sessions.factories.SessionManager.getManager();
Server server = (Server) manager.getSession(xmlLoader, ECLIPSELINK_SESSION_CONFIG, classLoader, false, false);
// Set the external transaction controller and use JTA transacion manager
server.setExternalTransactionController(eclipselinkTransactionController);

尝试的解决方案及遇到的问题 #

提出两种解决方向：

1. 寻找支持Jakarta的JEE事务管理器（尽管当前无需两阶段提交）
2. 使用Spring Boot自带的JPA实体管理器

尝试方案2时，通过EclipseLinkSessionService获取UnitOfWork返回空值，导致后续操作失败：

EclipseLinkSessionService service = EclipseLinkSessionServiceFactory.createService();
UnitOfWork uow = service.getUnitOfWork();
uow.registerObject(myEntity);

解决建议 #

方案1：替换Bitronix为Jakarta兼容的事务管理器 #

• 选用Narayana：完全支持Jakarta EE规范的开源JTA事务管理器，适配Spring Boot 3，同时支持本地事务模式（匹配当前无需两阶段提交的场景）
• 操作方式：引入Narayana的Spring Boot starter依赖，移除Bitronix相关配置，通过application.properties自动绑定事务管理器与EclipseLink，无需手动编写Session绑定代码

方案2：修复Spring Boot JPA下UnitOfWork空值问题 #

• 避免直接通过EclipseLinkSessionServiceFactory获取Session，改为通过Spring管理的EntityManager获取EclipseLink Session：

  @Autowired
  private EntityManager entityManager;
  
  public void persistEntity(MyEntity myEntity) {
      Session session = JpaHelper.getEntityManager(entityManager).getActiveSession();
      UnitOfWork uow = session.acquireUnitOfWork();
      uow.registerObject(myEntity);
      uow.commit();
  }
  

• 确保Spring Boot配置中指定EclipseLink为JPA实现：

  spring.jpa.provider=org.eclipse.persistence.jpa.PersistenceProvider
  spring.jpa.database-platform=org.eclipse.persistence.platform.database.YourDatabasePlatform
  

• 配置事务模式为本地事务（当前场景无需JTA），减少不必要的事务管理器依赖，简化配置

优先推荐方案 #

由于当前业务已无需两阶段提交，优先选择方案2：基于Spring Boot自带JPA实体管理器修复UnitOfWork问题，既符合Spring Boot轻量特性，又避免引入额外的JTA事务管理器依赖，降低维护成本

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