升级至Hibernate 6.0后出现UnknownEntity错误的问题咨询

静态初始化块抛出的ExceptionInInitializerError是初始化流程失败的包装异常，根因UnknownEntityException由Hibernate 6.0的不兼容API变更导致：

• Hibernate 6.0调整了Configuration类的加载逻辑：5.x及更早版本中调用configure("hibernate.cfg.xml")时，会自动解析配置文件中声明的所有<mapping resource="xxx.hbm.xml"/>节点，自动完成映射文件注册；6.0版本移除了这部分自动注册逻辑，原有代码流程仅加载了hibernate配置属性，没有加载任何实体映射元数据，运行时操作实体时自然会抛出未知实体异常。
• Hibernate 6.x并未移除hbm.xml映射形式的支持，不需要将所有hbm映射全量改造为注解形式，仅需调整初始化流程即可修复问题。

调整HibernateUtil静态块的初始化逻辑，在构建SessionFactory之前显式加载所有hbm映射资源，修复后的代码如下：

public class HibernateUtil {
  private static final SessionFactory sessionFactory;
  private static ServiceRegistry serviceRegistry;

  static {
    Configuration configuration = new Configuration().configure("hibernate.cfg.xml");
    // 显式注册cfg.xml中声明的所有hbm.xml映射资源
    configuration.getMappingReferences().forEach(mappingRef -> {
        String resourcePath = mappingRef.getResourceName();
        if (resourcePath != null && !resourcePath.isBlank()) {
            configuration.addResource(resourcePath);
        }
    });
    serviceRegistry = new StandardServiceRegistryBuilder()
            .applySettings(configuration.getProperties())
            .build();
    sessionFactory = configuration.buildSessionFactory(serviceRegistry);
  }

  // 原有getSessionFactory等工具方法保持原有逻辑即可
}

如果上述方式无法正确识别映射资源，可以使用更稳妥的手动解析配置方案，直接遍历hibernate.cfg.xml的mapping节点完成注册：

public class HibernateUtil {
  private static final SessionFactory sessionFactory;
  private static ServiceRegistry serviceRegistry;

  static {
    Configuration configuration = new Configuration();
    // 手动解析cfg.xml中的mapping节点
    try (InputStream cfgStream = HibernateUtil.class.getClassLoader()
            .getResourceAsStream("hibernate.cfg.xml")) {
        if (cfgStream == null) {
            throw new ExceptionInInitializerError("无法找到hibernate.cfg.xml配置文件");
        }
        Document configDoc = configuration.getStandardHbmConfigLoader()
                .loadConfig(cfgStream);
        List<Element> mappingNodes = configDoc.getRootElement().elements("mapping");
        for (Element node : mappingNodes) {
            String hbmPath = node.attributeValue("resource");
            if (hbmPath != null && !hbmPath.isBlank()) {
                configuration.addResource(hbmPath);
            }
        }
    } catch (Exception e) {
        throw new ExceptionInInitializerError(e);
    }
    // 加载其余配置属性
    configuration.configure("hibernate.cfg.xml");
    serviceRegistry = new StandardServiceRegistryBuilder()
            .applySettings(configuration.getProperties())
            .build();
    sessionFactory = configuration.buildSessionFactory(serviceRegistry);
  }
}

• 修复后启动阶段无映射相关报错时，可以通过打印sessionFactory.getMetamodel().getEntities()确认所有业务实体类都已被正确注册
• 同步检查所有hbm.xml文件的DTD声明，需更新为Hibernate 6.0对应的DTD版本，否则映射文件解析阶段会抛出错误
• 如果项目存在Spring与Hibernate的集成逻辑，需同步将spring-orm依赖升级到6.x版本，避免旧版本Spring集成逻辑不兼容Hibernate 6的SPI变更。

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