Spring Boot WebClient POST请求接收JSON字符串的正确用法

你当前通过ObjectMapper手动序列化Java对象为JSON字符串的方式是可行的，但WebClient本身内置了对Jackson的支持，直接传入Java对象进行序列化是更简洁高效的方案，无需手动调用ObjectMapper。

优化后的代码实现 #

你的AccountRequest实体类已经通过@JsonProperty指定了JSON属性名，这部分无需修改：

@Data
public class AccountRequest {
    @JsonProperty("event_header")
    private AccountEventHeader accountEventHeader;
    
    @JsonProperty("companyData")
    private List<CompanyData> companyRequestList;
}

直接将Java对象传入bodyValue()方法，WebClient会自动完成序列化：

ResponseEntity<String> responseData = this.webClient.post()
        .contentType(MediaType.APPLICATION_JSON)
        .bodyValue(accountRequest) // 直接传入Java对象，自动序列化为JSON
        .retrieve()
        .toEntity(String.class)
        .block();

为什么这种方式更高效？ #

• 减少样板代码：省去手动捕获JsonProcessingException的冗余代码，WebClient会自动处理序列化异常并转换为Spring规范的异常类型
• 配置统一：复用WebClient全局配置的ObjectMapper（比如项目中统一设置的日期格式、序列化特性），避免手动维护ObjectMapper实例导致的配置不一致问题
• 性能更优：WebClient的序列化逻辑经过优化，底层复用缓存的序列化器，比手动调用ObjectMapper的单次序列化效率更高

自定义序列化规则（可选） #

如果需要自定义Jackson序列化配置（比如忽略未知属性、自定义日期格式），可以通过配置WebClientBuilder全局设置：

@Bean
public WebClient webClient(WebClientBuilder webClientBuilder) {
    ObjectMapper customObjectMapper = new ObjectMapper()
            .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
            .setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
    
    return webClientBuilder
            .codecs(configurer -> {
                configurer.defaultCodecs().jackson2JsonEncoder(new Jackson2JsonEncoder(customObjectMapper));
                configurer.defaultCodecs().jackson2JsonDecoder(new Jackson2JsonDecoder(customObjectMapper));
            })
            .build();
}

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