如何在Feign Client中正确传递含特殊字符的PathVariable URL？

问题根源 #

当使用@PathVariable传递包含?、=、&这类特殊字符的路径片段时，Feign默认会对这些字符做URL编码，导致实际请求路径变成编码后的格式，触发404错误。

有效解决方法 #

方法一：改用Feign原生@RequestLine注解 #

Feign原生的@RequestLine支持直接传入带查询参数的完整路径，不会自动编码特殊字符：

@RequestLine("GET {nextUri}")
SearchResponse getNextPage(@Param("nextUri") String nextUri);

注意：使用该注解需要将Feign契约配置为feign.Contract.Default()，而非Spring MVC契约。

方法二：自定义请求拦截器还原转义字符 #

通过配置Feign的请求拦截器，手动将编码后的字符还原：

@Bean
public Feign.Builder customFeignBuilder() {
    return Feign.builder()
            .encoder(new JacksonEncoder())
            .decoder(new JacksonDecoder())
            .contract(new SpringMvcContract())
            .requestInterceptor(template -> {
                String encodedUrl = template.url();
                String decodedUrl = encodedUrl.replace("%3F", "?")
                                             .replace("%3D", "=")
                                             .replace("%26", "&");
                template.target(decodedUrl);
            });
}

方法三：拆分路径与查询参数传递 #

如果可以从nextUri中拆分出纯路径部分和查询参数，分开传递避免编码：

@GetMapping(value = "{path}")
SearchResponse getNextPage(
        @PathVariable("path") String path,
        @RequestParam MultiValueMap<String, String> queryParams);

调用时解析nextUri，将路径和参数分别传入方法。

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