Micronaut使用@Client发起外部调用报错及路径配置疑问

@Client 路径配置规则 #

• @Client 注解的参数仅用于配置目标服务的根地址，支持两类配置值：
  • 直连场景填写完整的服务根地址，例如 @Client("http://target-host:8080")
  • 服务发现场景填写注册中心上的服务ID，例如 @Client("external-service")
    禁止将具体业务接口的相对路径直接写在@Client注解参数中
• 具体接口的请求路径，必须配置在对应HTTP方法映射注解上，包括@Get、@Post等。

正确的接口定义示例：

import io.micronaut.http.HttpHeaders;
import io.micronaut.http.annotation.Get;
import io.micronaut.http.annotation.Header;
import io.micronaut.http.client.annotation.Client;

@Client("http://target-host:8080")
@Header(name = HttpHeaders.ACCEPT, value = "application/json")
public interface ExternalCall {
    // 业务接口路径配置在方法映射注解上
    @Get("/api/external/call")
    MyResponse call();
}

UnimplementedAdviceException 异常触发原因 #

该异常本质是Micronaut的AOP处理器找不到对应方法的实现逻辑，针对@Client场景，常见触发原因有3个：

• 配置不符合规则：例如将业务相对路径写在@Client上、@Get等方法注解未配置请求路径，框架无法识别方法对应的HTTP请求映射，无法生成客户端代理逻辑。
• 接口未被扫描到：Client接口定义的包路径不在Micronaut默认扫描范围内，通常是接口所在包与@MicronautApplication标注的启动类不在同包/子包下，且未手动配置组件扫描路径。
• 依赖缺失：构建配置中未引入micronaut-http-client依赖，客户端相关的AOP处理器未加载，无法为@Client注解的接口生成代理实现。

配置校验要点 #

• 确保Client接口在Micronaut的组件扫描范围内，必要时通过启动类上的@ComponentScan注解指定扫描包。
• 不要手动实例化Client接口，必须通过依赖注入方式获取代理实例。
• 确认@Client配置根地址、HTTP方法注解配置具体接口路径的规则，不要混用路径配置位置。

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