SpringQueryMap将查询参数放入请求体而非URL的问题排查

你混用了原生Feign注解（@RequestLine、@CollectionFormat）与Spring Cloud Feign的@SpringQueryMap，两者分属不同实现体系：原生Feign的处理逻辑无法识别@SpringQueryMap，会默认将DTO参数当作请求体参数，而非URL查询参数。

1. 统一使用Spring MVC风格注解替换原生Feign注解 #

将Feign客户端的注解全部替换为Spring MVC标准注解，确保@SpringQueryMap能被正确解析：

@FeignClient(name = "target-service", url = "http://your-target-service-url") // 必须指定name或url
public interface MyFeignClient {

    @GetMapping("/Users")
    BaseResponseWithResultSetDto<UserResponseDto> getAllowedUsers(@SpringQueryMap QueryDTO query);
}

2. 配置集合参数的CSV格式化 #

Spring Cloud Feign默认会将集合参数拆分为多值查询参数（如$select=UserCode&$select=InternalKey），要实现CSV格式拼接，可通过两种方式配置：

方式一：配置文件（application.yml）

spring:
  cloud:
    openfeign:
      formatter:
        collection-format: CSV

方式二：代码自定义转换器

@Configuration
public class FeignConfig {
    @Bean
    public FeignFormatterRegistrar feignFormatterRegistrar() {
        return registry -> registry.addConverter((Converter<List<String>, String>) source -> 
            String.join(",", source)
        );
    }
}

3. 确保DTO字段与URL参数名映射正确 #

通过Feign的@Parameter注解指定DTO字段对应的URL查询参数名，解决$select、$filter这类特殊参数名的映射问题：

public class QueryDTO{

    @Parameter(name = "$select")
    private List<String> select;
    @Parameter(name = "$filter")
    private List<String> filter;

    // getters + setters + add方法
}

4. 检查Feign客户端创建逻辑 #

确保你通过Spring容器注入Feign客户端，而非直接用原生Feign Builder构建——原生Builder不会加载Spring Cloud Feign的扩展逻辑（包括@SpringQueryMap的解析）。如果必须使用Builder，需要手动配置SpringQueryMapEncoder：

MyFeignClient client = Feign.builder()
        .encoder(new SpringQueryMapEncoder())
        .target(MyFeignClient.class, "http://your-target-service-url");

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