Micronaut声明式HTTP Client调用Get方法路由错误问题

核心问题是通用接口IHttpAction中get方法的@Get注解未正确声明路径参数占位符，导致Micronaut声明式HTTP Client将方法参数解析为查询参数而非路径参数，最终请求被错误路由到find接口。

修复步骤 #

1. 修正通用接口的get方法注解 #

给get方法的@Get注解添加路径参数占位符{id}，明确告知Micronaut该参数属于路径的一部分：

import io.micronaut.http.annotation.Get;
import java.util.UUID;
import java.util.List;

public interface IHttpAction<T> {
    // 正确配置路径参数占位符
    @Get("/{id}")
    T get(UUID id);

    // 查询参数形式的find方法，保持@Get无路径（匹配基础路径）
    @Get
    List<T> find(String keyword);
}

2. 确保客户端接口继承规则正确 #

TagHttpClient继承接口时无需额外修改，仅需保持@Client注解指向正确的基础路径：

import io.micronaut.http.client.annotation.Client;

@Client("/tag")
public interface TagHttpClient extends IHttpAction<Tag> {
}

3. 验证服务端控制器路由一致性 #

确认TagController中的get方法注解与接口规则匹配，保证客户端与服务端路由逻辑统一：

import io.micronaut.http.annotation.Controller;
import io.micronaut.http.annotation.Get;
import java.util.UUID;

@Controller("/tag")
public class TagController {
    @Get("/{id}")
    public Tag get(UUID id) {
        // 业务逻辑实现
    }

    @Get
    public List<Tag> find(String keyword) {
        // 业务逻辑实现
    }
}

问题根源解析 #

当get方法的@Get注解未指定路径参数占位符时，Micronaut默认会将方法参数识别为查询参数，生成的请求路径变为/tag/?arg0=xxx。而find方法的@Get注解匹配的是/tag/基础路径（查询参数不影响路由匹配），因此请求会被错误路由到find接口。

直接用curl访问/tag/xxx时，路径完全符合TagController中@Get("/{id}")的路由规则，所以能正常触发get方法。

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