为何未发现JPA实体时Quarkus会禁用Hibernate ORM？

当你在Quarkus项目中添加quarkus-hibernate-orm依赖但未定义任何带@Entity注解的JPA实体类时，启动时会收到如下警告：

WARN  [io.qua.hib.orm.dep.HibernateOrmProcessor] ... Hibernate ORM is disabled because no JPA entities were found

这种行为是Quarkus的设计逻辑导致的，核心原因和它的构建增强机制、资源优化目标直接相关：

• ORM核心功能依赖实体类
  Hibernate ORM的核心作用是映射JPA实体与数据库表，提供实体的CRUD、查询等操作能力。如果项目中没有任何实体类，ORM组件没有可执行的核心逻辑，启用它完全没有实际意义。Quarkus会自动识别这种场景，直接禁用ORM模块，避免做无用功。

• 和Quarkus构建增强（Augmentation）机制直接相关
  Quarkus的构建阶段会执行静态代码分析与增强处理，其中就包括扫描项目中的@Entity注解类，生成实体元数据、优化EntityManagerFactory的初始化逻辑等。如果扫描不到任何实体类，构建增强流程会判定Hibernate ORM没有必要初始化，因此会在构建阶段就标记该模块为禁用状态，跳过所有相关的初始化步骤——这也是Quarkus"提前优化"的典型体现。

• 为了极致的资源节省与启动速度
  Quarkus的核心优势之一是快速启动与低内存占用。如果保留未使用的ORM模块，会额外加载大量Hibernate相关类、初始化实体管理工厂、甚至触发不必要的数据库连接池配置，这些都会拖慢启动速度、增加内存开销。禁用无用的ORM模块是Quarkus践行"只加载必要组件"理念的具体措施。

如果你的场景确实需要在无实体类的情况下使用Hibernate ORM（比如仅用原生SQL操作数据库），可以通过在application.properties中添加配置强制启用：

quarkus.hibernate-orm.enabled=true

但这种场景非常少见，一般不建议这么做，因为会引入不必要的资源消耗。

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