Quarkus 3.6.6中无法命名数据源为"query"的问题咨询

问题重现 #

• 使用Quarkus 3.6.6版本，克隆quarkus-quickstarts仓库中的hibernate-orm-panache-quickstart项目
• 第一次配置application.properties，将数据源和持久化单元名称设为"query"：

quarkus.datasource.query.db-kind=postgresql

quarkus.hibernate-orm.query.datasource=query
quarkus.hibernate-orm.query.packages=org.acme.hibernate.orm.panache.entity,org.acme.hibernate.orm.panache.repository
quarkus.hibernate-orm.query.database.generation=drop-and-create
quarkus.hibernate-orm.query.log.sql=true
quarkus.hibernate-orm.query.sql-load-script=import.sql

运行测试失败，错误日志：

java.lang.RuntimeException: java.lang.RuntimeException: io.quarkus.builder.BuildException: Build failure: Build failed due to errors
    [error]: Build step io.quarkus.hibernate.orm.deployment.HibernateOrmProcessor#configurationDescriptorBuilding threw an exception: io.quarkus.runtime.configuration.ConfigurationException: Model classes are defined for the default persistence unit, but no default datasource was found. The default EntityManagerFactory will not be created. To solve this, configure the default datasource. Refer to https://quarkus.io/guides/datasource for guidance.

• 将名称改为"query-service"后重新配置，测试运行成功：

quarkus.datasource.query-service.db-kind=postgresql

quarkus.hibernate-orm.query-service.datasource=query-service
quarkus.hibernate-orm.query-service.packages=org.acme.hibernate.orm.panache.entity,org.acme.hibernate.orm.panache.repository
quarkus.hibernate-orm.query-service.database.generation=drop-and-create
quarkus.hibernate-orm.query-service.log.sql=true
quarkus.hibernate-orm.query-service.sql-load-script=import.sql

疑问 #

"query"是否为Quarkus的保留字？能否优化错误提示信息，或允许使用"query"作为数据源名称？

解答 #

1. "query"是否为保留字？
   "query"并非Quarkus的全局保留字，但在Hibernate ORM的配置命名空间中，quarkus.hibernate-orm.query.是框架内置的配置前缀（用于设置全局查询缓存、查询超时等查询相关参数）。当你将"query"作为自定义持久化单元名称时，框架会误将quarkus.hibernate-orm.query.datasource这类配置识别为全局查询配置，而非某个持久化单元的专属配置，导致无法识别你定义的持久化单元，进而抛出"未找到默认数据源"的错误。

2. 错误提示能否优化？
   当前错误提示未关联到"query"名称与内置配置前缀的冲突问题，确实存在优化空间。Quarkus可以在构建阶段增加检测逻辑，当发现持久化单元名称与内置配置关键字重叠时，给出针对性提示，帮助开发者快速定位问题。

3. 能否使用"query"作为数据源名称？
   数据源名称本身可以使用"query"，但需避免将其作为持久化单元名称。如果一定要保留名为"query"的数据源，可调整配置：将持久化单元名称改为非冲突名称，再指定其使用该数据源，示例如下：

quarkus.datasource.query.db-kind=postgresql

quarkus.hibernate-orm.custom-pu.datasource=query
quarkus.hibernate-orm.custom-pu.packages=org.acme.hibernate.orm.panache.entity,org.acme.hibernate.orm.panache.repository
quarkus.hibernate-orm.custom-pu.database.generation=drop-and-create
quarkus.hibernate-orm.custom-pu.log.sql=true
quarkus.hibernate-orm.custom-pu.sql-load-script=import.sql

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