Quarkus中REST Client替代实现方式及测试异常排查

一、正确实现步骤 #

1. 定义REST Client接口 #

• 确保MyAPI是纯Java接口，不能是抽象类或普通类
• 接口上添加@RegisterRestClient注解，标记为Quarkus REST Client接口
• 结合@LookupIfProperty(name = "myapp.mode", value = "real")实现条件激活，仅当配置值为real时，使用Quarkus自动生成的REST代理实现
• 无需额外添加@ApplicationScoped（Quarkus 2.x及以上版本中，@RegisterRestClient已隐含CDI作用域）

2. 编写Mock替代实现 #

• MockMyAPI必须严格实现MyAPI接口
• 类上添加@RestClient注解，表明这是REST Client的自定义替代实现
• 添加@ApplicationScoped注解，确保被CDI容器管理
• 用@LookupIfProperty(name = "myapp.mode", value = "mock")实现条件激活，仅当配置值为mock时启用该Mock实现

二、测试异常原因及解决 #

你遇到的IncompatibleClassChangeError（提示MyAPI不是接口），核心原因是测试环境中Quarkus的编译增强逻辑与配置隔离不到位，具体排查方向如下：

• 配置冲突：检查src/test/resources/application.properties，确保测试时myapp.mode值唯一（不能同时触发real和mock的激活条件），避免CDI容器尝试同时加载两种实现导致类类型判断混乱
• 类路径缓存残留：Quarkus编译时会为@RegisterRestClient接口生成代理类，旧的代理类缓存可能导致JVM误判MyAPI类型。执行./mvnw clean（Maven）或./gradlew clean（Gradle）清理构建缓存后重新编译测试
• 测试依赖重复：检查测试依赖，避免重复引入Quarkus REST Client相关jar包，防止类路径冲突
• 低版本兼容性：如果使用Quarkus 1.x版本，需在MyAPI接口上显式添加@ApplicationScoped，确保CDI容器正确识别其接口类型
• 测试Profile隔离：创建专属测试Profile（通过@QuarkusTestProfile注解），在测试时强制指定激活的实现，避免环境配置干扰

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