Quarkus多后端数据库支持咨询：突破构建时配置锁定方案

针对Quarkus构建时锁定db-kind、jdbc.driver等核心数据源配置的问题，以下是几个实用的实现方案：

方案1：运行时动态配置数据源（推荐） #

绕过Quarkus构建时的数据源固化逻辑，通过编程方式在运行时根据外部配置动态创建数据源和Hibernate会话。

步骤： #

1. 禁用内置数据源自动配置
   在application.properties中添加：

   quarkus.datasource.enabled=false
   quarkus.hibernate-orm.enabled=false
   

2. 自定义数据源Producer
   编写CDI Producer，根据运行时配置加载对应驱动、创建数据源（以Agroal连接池为例）：

   import io.agroal.api.AgroalDataSource;
   import io.agroal.api.configuration.AgroalConnectionFactoryConfiguration;
   import io.agroal.api.configuration.AgroalDataSourceConfiguration;
   import jakarta.enterprise.context.ApplicationScoped;
   import jakarta.enterprise.inject.Produces;
   import org.eclipse.microprofile.config.inject.ConfigProperty;
   
   @ApplicationScoped
   public class DynamicDataSourceProducer {
   
       @ConfigProperty(name = "app.db.url")
       String dbUrl;
   
       @ConfigProperty(name = "app.db.driver")
       String dbDriver;
   
       @ConfigProperty(name = "app.db.username")
       String dbUser;
   
       @ConfigProperty(name = "app.db.password")
       String dbPassword;
   
       @Produces
       @ApplicationScoped
       public AgroalDataSource produceDataSource() {
           var connectionFactoryConfig = AgroalConnectionFactoryConfiguration.builder()
                   .jdbcUrl(dbUrl)
                   .driverClassName(dbDriver)
                   .principal(dbUser)
                   .credential(dbPassword.toCharArray())
                   .build();
   
           var dataSourceConfig = AgroalDataSourceConfiguration.builder()
                   .connectionFactoryConfiguration(connectionFactoryConfig)
                   .maxSize(20)
                   .minSize(5)
                   .build();
   
           return AgroalDataSource.from(dataSourceConfig);
       }
   }
   

3. 动态配置Hibernate ORM
   自定义Hibernate SessionFactory Producer，根据数据源和配置的方言初始化：

   import jakarta.enterprise.context.ApplicationScoped;
   import jakarta.enterprise.inject.Produces;
   import jakarta.inject.Inject;
   import org.hibernate.SessionFactory;
   import org.hibernate.cfg.Configuration;
   import javax.sql.DataSource;
   import org.eclipse.microprofile.config.inject.ConfigProperty;
   
   @ApplicationScoped
   public class HibernateSessionFactoryProducer {
   
       @Inject
       DataSource dataSource;
   
       @ConfigProperty(name = "app.hibernate.dialect")
       String hibernateDialect;
   
       @Produces
       @ApplicationScoped
       public SessionFactory produceSessionFactory() {
           Configuration configuration = new Configuration();
           configuration.setProperty("hibernate.connection.datasource", dataSource);
           configuration.setProperty("hibernate.dialect", hibernateDialect);
           // 扫描实体类包路径
           configuration.addPackage("com.yourpackage.entity");
           // 添加其他Hibernate配置
           configuration.setProperty("hibernate.hbm2ddl.auto", "update");
   
           return configuration.buildSessionFactory();
       }
   }
   

4. 运行时切换配置
   终端用户只需在启动应用时传入对应数据库的配置参数：

   # Postgres示例
   java -jar your-app.jar -Dapp.db.url=jdbc:postgresql://localhost:5432/dbname -Dapp.db.driver=org.postgresql.Driver -Dapp.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
   
   # SQL Server示例
   java -jar your-app.jar -Dapp.db.url=jdbc:sqlserver://localhost:1433;databaseName=dbname -Dapp.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver -Dapp.hibernate.dialect=org.hibernate.dialect.SQLServerDialect
   

方案2：利用Quarkus的可扩展数据源配置（半动态） #

Quarkus允许通过构建时参数保留部分配置的运行时可变性，核心是将db-kind设置为other，手动指定驱动和方言。

步骤： #

1. 基础配置
   在application.properties中配置通用参数，将db-kind设为other以避免构建时锁定：

   quarkus.datasource.db-kind=other
   quarkus.datasource.jdbc.driver=${app.db.driver:org.postgresql.Driver}
   quarkus.datasource.jdbc.url=${app.db.url:jdbc:postgresql://localhost:5432/dbname}
   quarkus.datasource.username=${app.db.username:postgres}
   quarkus.datasource.password=${app.db.password:postgres}
   
   quarkus.hibernate-orm.dialect=${app.hibernate.dialect:org.hibernate.dialect.PostgreSQLDialect}
   

2. 确保驱动依赖为运行时依赖
   在pom.xml中添加多数据库驱动，设置为runtime scope，避免构建时绑定：

   <dependencies>
       <!-- Postgres驱动 -->
       <dependency>
           <groupId>org.postgresql</groupId>
           <artifactId>postgresql</artifactId>
           <scope>runtime</scope>
       </dependency>
       <!-- SQL Server驱动 -->
       <dependency>
           <groupId>com.microsoft.sqlserver</groupId>
           <artifactId>mssql-jdbc</artifactId>
           <scope>runtime</scope>
       </dependency>
       <!-- Quarkus Hibernate ORM -->
       <dependency>
           <groupId>io.quarkus</groupId>
           <artifactId>quarkus-hibernate-orm</artifactId>
       </dependency>
       <!-- Quarkus Agroal连接池 -->
       <dependency>
           <groupId>io.quarkus</groupId>
           <artifactId>quarkus-agroal</artifactId>
       </dependency>
   </dependencies>
   

3. 运行时切换
   用户启动时只需覆盖对应参数即可切换数据库，无需修改应用包：

   java -jar your-app.jar -Dapp.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver -Dapp.db.url=jdbc:sqlserver://localhost:1433;databaseName=dbname -Dapp.hibernate.dialect=org.hibernate.dialect.SQLServerDialect
   

方案3：自定义Hibernate会话工厂（完全可控） #

如果需要更精细的控制（比如多数据源切换、自定义会话管理），可以完全绕过Quarkus的Hibernate ORM扩展，手动管理SessionFactory。

核心要点： #

• 排除Quarkus的quarkus-hibernate-orm扩展，直接引入Hibernate核心依赖。
• 编写会话工厂管理器，根据配置动态加载不同数据库的方言和驱动。
• 实现CDI Producer注入Session或EntityManager，供业务代码使用。

这种方案适合需要高度定制化的场景，但需要自行处理连接池、事务管理等细节。

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