Quarkus集成Hibernate ORM 实现有库/无库双部署模式的问题咨询

该场景完全可以落地，不需要拆分代码、不需要维护两个独立构建产物，通过Quarkus原生的profile机制加精准的配置开关就能实现，之前遇到的两类报错，本质是配置打在了非关键节点上，没对准扩展的实际启动/构建逻辑。

两类报错的实际根因 #

• 配置quarkus.datasource.jdbc.initial-size=0仍报数据库连接超时：
  这个参数只控制Agroal连接池启动时不预创建核心空闲连接，但Hibernate ORM扩展在启动阶段会主动从连接池拿连接，做数据库元数据读取、方言探测、Schema校验等操作，这个取连动作不受initial-size参数限制，哪怕池内初始没有连接，还是会发起实际的TCP建连请求，最终抛超时异常。
• 配置quarkus.datasource.jdbc=false直接构建失败：
  只要类路径下存在quarkus-hibernate-orm依赖，构建阶段的Hibernate处理逻辑会强制校验“默认数据源必须有合法配置”，没有符合要求的数据源定义就直接中断构建流程，根本走不到运行时阶段。

适配当前Quarkus 1.12.1.Final版本的可落地方案 #

核心逻辑是：无数据库模式下，给各扩展提供满足构建期校验要求的占位配置，同时关闭所有会触发实际建连的流程，让应用启动全程不访问真实数据库。所有配置通过profile隔离，完全不影响正常带库运行的模式：

1. 保留默认application.properties中连接真实Oracle数据库的全量配置，对应正常生产运行场景
2. 新增无数据库专属的%no-dbprofile配置块，所有配置项带%no-db.前缀，仅在指定无数据库profile启动时生效：

   # 占位H2内存库配置，满足Hibernate构建期的数据源校验要求，不会再发起对原Oracle地址的连接请求
   %no-db.quarkus.datasource.db-kind=h2
   %no-db.quarkus.datasource.jdbc.url=jdbc:h2:mem:no_db_mode;DB_CLOSE_DELAY=-1
   %no-db.quarkus.datasource.jdbc.username=sa
   %no-db.quarkus.datasource.jdbc.password=
   # 开启连接池全懒加载，无实际业务调用就不创建任何物理连接
   %no-db.quarkus.datasource.jdbc.lazy=true
   # 关闭内置的数据源健康检查，避免健康探针触发连接校验
   %no-db.quarkus.datasource.health.enabled=false
   # 关闭Hibernate启动阶段所有和数据库交互的动作
   %no-db.quarkus.hibernate-orm.database.generation=none
   %no-db.quarkus.hibernate-orm.schema-management.enabled=false
   %no-db.quarkus.hibernate-orm.statistics=false
   

3. 启动时按场景指定profile即可：
   • 带数据库的运行场景：正常启动应用，加载Oracle连接配置
   • 无数据库的运行场景：启动时增加JVM参数-Dquarkus.profile=no-db，整个启动过程不会向原Oracle地址发起TCP连接，也不会触发构建期的数据源校验错误。

落地注意事项 #

• 同一套应用二进制包即可支持两种模式切换，不需要分别打包，无数据库模式下也不需要移除Hibernate、DataSource相关的依赖
• 需要确保无数据库模式下，没有任何业务代码主动调用EntityManager、持久层Repository方法，否则懒加载的连接池会在第一次持久层调用时触发建连，这属于业务逻辑的边界问题，和框架配置无关
• 如果应用提供的接口涉及数据库操作，可以在无数据库模式下加简单的拦截器逻辑，对持久层相关的接口统一返回“当前模式未启用数据库能力”的响应，避免运行时触发意外的连接行为

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