Quarkus Rest Client配置绑定失败：无法确定baseUrl/baseUri

问题场景 #

使用Quarkus Rest Client发送POST请求时，application.yml中的配置无法绑定到带有@RegisterRestClient注解的接口，抛出java.lang.IllegalArgumentException: Unable to determine the proper baseUrl/baseUri异常。已尝试使用configKey和类全名进行配置，问题依旧。

环境信息 #

• Quarkus版本：2.7.6.Final
• Maven：3.8.5
• Java：17（OpenJDK Temurin-17.0.4.1）
• 系统：Windows 10

可能的解决方案 #

1. 校验配置的层级与拼写 #

确保application.yml中Rest Client的配置结构正确，避免层级错误或拼写失误：

• 使用configKey配置（对应接口的@RegisterRestClient(configKey="product-client")）：

  quarkus:
    rest-client:
      product-client:
        url: "https://your-target-api-base-url.com"
        scope: javax.inject.Singleton
  

• 使用类全名配置：

  quarkus:
    rest-client:
      com.your.package.ProductSender:
        url: "https://your-target-api-base-url.com"
        scope: javax.inject.Singleton
  

2. 确认依赖完整性 #

检查pom.xml是否包含Rest Client的核心依赖，若涉及JSON序列化需额外添加Jackson依赖：

<dependencies>
    <!-- Quarkus Rest Client核心依赖 -->
    <dependency>
        <groupId>io.quarkus</groupId>
        <artifactId>quarkus-rest-client</artifactId>
    </dependency>
    <!-- JSON序列化依赖（若需要） -->
    <dependency>
        <groupId>io.quarkus</groupId>
        <artifactId>quarkus-rest-client-jackson</artifactId>
    </dependency>
</dependencies>

3. 规范接口注入方式 #

确保Rest Client接口通过@Inject+@RestClient注解正确注入，而非手动实例化：

@Inject
@RestClient
ProductSender productSender;

4. 版本兼容性优化 #

Quarkus 2.7.x对Java 17的支持存在部分局限性，建议升级到Quarkus 2.13.x（LTS版本），该版本修复了多个与Java 17兼容的问题，能有效减少此类配置绑定异常。

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