Feign调用时POST请求RequestBody JSON被塞入首个参数名如何解决

问题根源 #

你当前的配置存在逻辑冲突：接口用@FormParam注解声明要传递表单参数，但Feign客户端配置的编码器是JacksonEncoder，该编码器会把所有入参直接序列化为JSON字符串作为整体请求体发送，就出现了你观察到的整段JSON被塞进单个参数的异常情况。

修复方案 #

1. 替换适配表单的编码器 #

把Feign构建逻辑中的编码器替换为FormEncoder，如果需要同时兼容JSON编码场景可以做嵌套配置：

private OAuth2RequestService workerRestService(
        final FeignOptions<OAuth2RequestService> options) {
    final Request.Options requestOptions =
            new Request.Options(options.getConnectionTimeOut(), options.getReadTimeOut());
    return Feign.builder().options(requestOptions).client(new OkHttpClient())
            .contract(new JAXRSContract())
            // 替换JacksonEncoder为FormEncoder，支持表单参数拆分序列化
            .encoder(new FormEncoder(new JacksonEncoder()))
            .decoder(new JacksonDecoder()).decode404()
            .target(OAuth2RequestService.class, options.getHostUrl());
}

如果项目未引入表单编码器依赖，需要先添加对应Maven坐标：

<dependency>
    <groupId>io.github.openfeign.form</groupId>
    <artifactId>feign-form</artifactId>
    <version>和你项目Feign核心版本匹配的版本号</version>
</dependency>

2. 优化Content-Type配置 #

不用手动传递Content-Type头参数，直接在接口上添加@Consumes注解更规范：

@Path("/")
public interface OAuth2RequestService {
    @POST
    // 声明消费表单类型，Feign会自动匹配对应请求头
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    AccessTokenRecord create(@FormParam(value = "grant_type") String grantType,
                             @FormParam(value = "client_id") String clientId,
                             @FormParam(value = "client_secret") String clientSecret);
}

调整后调用方法时不需要再传入HEADER_TYPE参数，简化调用逻辑。

3. 验证请求结果 #

调整完成后重新发起调用，请求体会自动转为标准表单格式：
grant_type=client_credentials&client_id=OC_CLIENT_ID&client_secret=OC_CLIENT_SECRET
完全符合你期望的拆分独立键值对的要求，服务端可以正常识别每个参数。

同类问题排查思路 #

• 先确认目标接口要求的请求体格式：表单（x-www-form-urlencoded）/JSON/其他
• 对应匹配Feign编码器：表单用FormEncoder、JSON用JacksonEncoder
• 参数注解要和编码器匹配：表单参数用@FormParam、JSON体用@RequestBody、URL参数用@QueryParam

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