Feign的GET请求如何传递对象参数？

在 Feign 中，GET 请求传递对象参数是一个常见的开发痛点。根据 HTTP 规范，GET 请求的参数应该拼接在 URL 的查询字符串（Query String）中，而不允许携带请求体（Request Body）。

当你在 Feign 的 GET 请求接口中直接传入一个复杂对象时，Feign 默认不知道如何将对象的字段映射到 URL 参数上，这通常会导致服务端接收不到参数，或者直接抛出 java.lang.IllegalArgumentException: method GET must not have a request body 异常。

为了解决这个问题，有以下几种主流的解决方案：

方案一：使用 @SpringQueryMap 注解（🌟最推荐）

这是 Spring Cloud OpenFeign 提供的一种优雅且语义清晰的解决方案。加上这个注解后，Feign 会通过反射自动将对象内部的属性展开，并拼接为 URL 查询参数（例如 ?username=zhangsan&passwd=***）。

• 优点：代码改动最小、符合 RESTful 规范、后续对象增加字段无需修改接口代码。
• 注意：需要确保你的 Spring Cloud 版本在 2.1.x 及以上。

@FeignClient(name = "user-service")
public interface UserFeignClient {
    @GetMapping("/users/list")
    List<UserDTO> listUsers(@SpringQueryMap UserQueryRequest request);
}

方案二：手动拆分参数 + @RequestParam

如果不想使用 @SpringQueryMap，或者需要传递的参数较少，可以在 Feign 接口中将对象的属性手动拆解，并显式添加 @RequestParam 注解。

• 优点：不依赖特定版本的注解，兼容性好。
• 缺点：如果对象字段很多，会导致方法签名极其冗长，维护成本高。

@FeignClient(name = "user-service")
public interface UserFeignClient {
    @GetMapping("/users/list")
    List<UserDTO> listUsers(
        @RequestParam("pageNum") Integer pageNum, 
        @RequestParam("pageSize") Integer pageSize
    );
}

方案三：改用 POST 请求 + @RequestBody

如果业务逻辑允许，或者查询条件确实非常复杂（例如包含嵌套对象、长文本等），建议直接将请求方式改为 POST。POST 请求支持将复杂对象序列化为 JSON 格式放入请求体中发送。

• 优点：彻底避开 GET 请求对参数的限制，适合复杂查询场景。
• 缺点：改变了原有的 HTTP 动词语义（GET 变 POST）。

@FeignClient(name = "user-service")
public interface UserFeignClient {
    @PostMapping("/users/list")
    List<UserDTO> listUsers(@RequestBody UserQueryRequest request);
}

总结建议：在日常的微服务开发中，如果是常规的 GET 列表查询，强烈建议使用 方案一 (**@SpringQueryMap**)；如果是涉及多表关联或条件极多的复杂检索，推荐使用 方案三 (POST + RequestBody)。