Quarkus容器环境下通过环境变量开启Hibernate ORM指标失效问题

核心场景 #

基于Quarkus v3.4.1 + MicroMeter扩展的Java应用，遇到以下问题：

• 容器内通过环境变量QUARKUS_HIBERNATE_ORM_METRICS_ENABLED=true无法开启Hibernate ORM指标，metrics端点无hibernate_*相关指标
• 直接在application.properties中配置quarkus.hibernate-orm.metrics.enabled=true时，指标可正常出现在metrics响应中
• 本地通过Maven运行时，环境变量配置可正常生效，仅容器环境复现问题
• quarkus.hibernate-orm.enabled未显式设置，默认应为true

排查与解决方向 #

1. 确认容器镜像类型与配置生效时机 #

Quarkus部分配置属于构建时配置，尽管文档未明确标注quarkus.hibernate-orm.metrics.enabled为构建时选项，但如果容器使用的是原生镜像（Native Image），构建阶段未启用该配置的话，运行时通过环境变量无法覆盖构建时的默认值。

• 若为原生镜像，需在构建阶段传入该环境变量，示例命令：

  ./mvnw package -Dquarkus.native.container-build=true -DQUARKUS_HIBERNATE_ORM_METRICS_ENABLED=true
  

• 若为JVM镜像，检查容器启动脚本是否正确传递环境变量，避免变量被启动逻辑覆盖或未加载。

2. 验证容器内环境变量的实际加载情况 #

进入容器内部执行以下命令，确认环境变量是否正确读取：

echo $QUARKUS_HIBERNATE_ORM_METRICS_ENABLED

同时查看Quarkus启动日志，搜索quarkus.hibernate-orm.metrics.enabled相关输出，确认运行时实际加载的配置值是否为true。

3. 排查配置覆盖与命名问题 #

检查是否存在环境特定配置文件（如application-prod.properties）覆盖了该设置，同时确认环境变量名称无拼写错误（注意大小写、下划线匹配）。

4. 显式强制Hibernate ORM启用状态 #

虽然默认quarkus.hibernate-orm.enabled=true，但容器环境下可能存在隐式配置变更，可添加环境变量QUARKUS_HIBERNATE_ORM_ENABLED=true，确保Hibernate ORM本身处于启用状态后，再验证指标是否生效。

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