Feign-OkHttp POST含URL查询参数请求出现异常问题求助

刚看到你遇到的这个问题——把项目里的HttpURLConnection换成Feign-OkHttp（用的是9.6.0版本）之后，POST请求 http://gclife-platform-service:20000/v1/user/login/log?userId=ea9dd2f707a54b11b03193c35b2ad3a4&error=SUCCESS 时，服务器日志出现了奇怪的Received [1.1 cache-...内容。我来帮你梳理下可能的原因和解决方法：

1. 先排查OkHttp的默认缓存拦截器干扰 #

Feign-OkHttp默认会集成OkHttp的缓存机制，但POST请求按HTTP规范是不应该被缓存的，很可能是默认的缓存拦截器在请求里添加了异常的头信息或者修改了请求结构，导致服务器解析出问题。你可以手动配置Feign的OkHttpClient，直接禁用缓存：

@Configuration
public class FeignOkHttpCustomConfig {
    @Bean
    public OkHttpClient okHttpClient() {
        return new OkHttpClient.Builder()
                .cache(null) // 彻底禁用缓存
                .build();
    }
}

然后在你的FeignClient注解里指定这个配置类：

@FeignClient(name = "gclife-platform-service", configuration = FeignOkHttpCustomConfig.class)
public interface UserLoginLogClient {
    // 你的接口方法
}

2. 检查Feign接口的参数绑定是否正确 #

你当前的POST请求把参数放在了URL的Query里，虽然POST允许这么做，但Feign的参数绑定如果处理不当，可能会导致请求格式异常。建议不要手动拼接URL，改用Feign的注解来绑定参数，示例如下：

@FeignClient(name = "gclife-platform-service", url = "http://gclife-platform-service:20000")
public interface UserLoginLogClient {
    @PostMapping("/v1/user/login/log")
    ResponseEntity<Void> submitLoginLog(
            @RequestParam("userId") String userId,
            @RequestParam("error") String error
    );
}

这种方式能让Feign自动处理参数拼接和请求头设置，减少手动拼接带来的格式错误。

3. 考虑版本兼容性问题 #

你使用的feign-okhttp:9.6.0是比较老旧的版本了，如果你的项目依赖的Spring Boot/Spring Cloud版本较新，很可能存在版本不兼容的情况——比如Feign的请求协议处理、拦截器逻辑和新版本的Spring组件冲突，导致请求发送异常。

建议先查看你的Spring Cloud版本对应的Feign兼容版本（比如Spring Cloud Greenwich对应Feign 10.x版本），升级feign-okhttp到匹配的版本后再测试。

4. 拉取完整的服务器日志定位细节 #

你提到服务器日志只显示了Received [1.1 cache-...，后面的截断内容很可能包含关键信息——比如异常的请求头、请求体片段，或者服务器解析请求时的具体错误。把完整日志拉出来后，能更精准地定位是请求头异常、协议版本问题还是其他因素导致的。

先从禁用缓存这个最简单的步骤开始排查，大部分情况下这类和cache相关的异常都能通过这个方法解决，如果不行再依次检查参数绑定和版本问题。

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