OpenFeign参数注解解析：@SpringQueryMap

OpenFeign参数注解深度解析：从@SpringQueryMap到完整参数传递方案

一、@SpringQueryMap：GET请求对象参数传递的终极方案

1.1 核心特性

• 对象转查询参数：自动将POJO对象属性转换为URL查询字符串（如?name=John&age=25）
• 嵌套对象支持：支持嵌套对象属性展开（如address.city=NewYork）
• Spring Cloud 2.1+专属：相比原生Feign的@QueryMap，完美集成Spring生态

1.2 使用示例

@Data
public class UserQuery {
    private String name;
    private Integer age;
    private Address address; // 嵌套对象
}

@FeignClient(name = "user-service")
public interface UserClient {
    @GetMapping("/users")
    List<User> search(@SpringQueryMap UserQuery query);
}

调用search()生成的URL示例：/users?name=John&age=25&address.city=NewYork