使用smallrye-mutiny-vertx-consul-client容器化时遇ConfigValidationException

你遇到的核心问题是：容器化启动时Quarkus自动加载了Consul Config扩展（用于从Consul拉取配置），但你并未配置该扩展所需属性，导致触发ConfigValidationException。本地运行正常是因为IntelliJ的dev模式未自动启用该扩展，或是容器构建时的依赖树与本地存在差异。

1. 排除不必要的Consul Config依赖 #

你使用的smallrye-mutiny-vertx-consul-client仅用于服务注册，完全不需要quarkus-config-consul扩展（该扩展用于从Consul拉取配置）。先排查依赖树确认是否被间接引入，再进行排除：

• 查看依赖树：

  ./gradlew dependencies | grep quarkus-config-consul
  

• 在build.gradle中排除依赖：

  // 针对vertx consul客户端单独排除
  implementation("io.smallrye.reactive:smallrye-mutiny-vertx-consul-client:3.11.0") {
      exclude group: 'io.quarkiverse.config', module: 'quarkus-config-consul'
  }
  
  // 若不确定来源，可全局排除
  configurations.all {
      exclude group: 'io.quarkiverse.config', module: 'quarkus-config-consul'
  }
  

2. 明确禁用Consul Config扩展 #

若排除依赖后问题仍存在，直接在配置中禁用该扩展：
在application.properties中添加：

quarkus.extensions.disabled=io.quarkiverse.config:quarkus-config-consul

或在容器启动命令中添加JVM参数：

java -Dquarkus.extensions.disabled=io.quarkiverse.config:quarkus-config-consul -jar your-app.jar

3. 检查容器构建配置 #

确认Dockerfile是否正确构建Quarkus应用，避免构建时自动引入不必要的扩展：

FROM gradle:8-jdk21 AS build
COPY --chown=gradle:gradle . /home/gradle/src
WORKDIR /home/gradle/src
RUN gradle quarkusBuild --no-daemon

FROM eclipse-temurin:21-jre
COPY --from=build /home/gradle/src/build/quarkus-app/lib/ /deployments/lib/
COPY --from=build /home/gradle/src/build/quarkus-app/*.jar /deployments/
COPY --from=build /home/gradle/src/build/quarkus-app/app/ /deployments/app/
COPY --from=build /home/gradle/src/build/quarkus-app/quarkus/ /deployments/quarkus/
ENTRYPOINT ["java", "-jar", "/deployments/quarkus-run.jar"]

4. 修正配置验证禁用方式 #

若之前禁用验证的方式无效，尝试精准关闭SmallRye Config的配置验证：

quarkus.smallrye-config.validation.enabled=false

1. 修改依赖或配置后重新构建镜像：

   docker-compose build
   

2. 启动容器验证：

   docker-compose up
   

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