Payara 2024.7部署多租户应用偶发数据源启动异常求助

错误类型1（连接获取NPE+事务异常） #

• 延迟Hibernate初始化
  在persistence.xml中添加<property name="hibernate.hbm2ddl.auto" value="none"/>（无需自动建表时），避免应用资源未就绪时触发数据库连接。同时检查自定义DatabaseMultiTenantProvider，将数据源操作移至@PostConstruct方法执行，不要在构造阶段直接获取数据源。
• 修复Payara事务与缓存
  修改Payara域配置，将transaction-service的lazy-enlistment设为true，避免在未就绪的事务上下文尝试恢复连接。另外删除payara/glassfish/domains/domain1/generated和cache目录下的内容，清理旧部署残留数据。

错误类型2（数据源无效） #

• 统一应用与数据源名称
  检查项目配置中的应用名称，确保与日志里的myApp2一致，避免JNDI查找时名称不匹配。persistence.xml中的jta-data-source直接配置为java:app/jdbc/myAppDS，不要使用自动生成的__pm后缀版本。
• 提前初始化数据源
  将数据源设置为Payara服务器级资源，而非应用级资源，确保服务器启动时就完成数据源初始化。若必须使用应用级数据源，确认glassfish-resources.xml中的<jndi-name>为java:app/jdbc/myAppDS，且正确打包到应用的WEB-INF或META-INF目录下。

通用修复步骤 #

• 清理过时配置
  删除persistence.xml中已废弃的hibernate.enhancer.enableLazyInitialization和hibernate.enhancer.enableDirtyTracking属性，Hibernate 6.5+默认启用相关功能。同时移除hibernate.dialect的显式设置，Hibernate 6会自动检测数据库方言。
• 调整Netbeans部署逻辑
  在项目属性的“部署”选项卡勾选“部署前清理服务器”，保证每次部署均为干净状态。或者手动启动Payara服务器后再部署应用，避免Netbeans同时启动服务器和部署导致的时序冲突。
• 验证多租户迁移完整性
  检查DatabaseMultiTenantProvider中的所有API是否已从javax命名空间替换为jakarta，例如javax.sql.DataSource需改为jakarta.sql.DataSource。同时确认Hibernate多租户配置属性适配Jakarta EE 10环境。

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