Spring Boot WebClient POST请求嵌套DTO字段为null的解决方法

算力阿峰

2026-8-30

问题排查思路

优先验证DTO序列化逻辑：你定义的B、Z类所有字段都是private修饰，既没有写public的getter方法，也没有配置Jackson对私有字段的访问权限。Jackson默认的序列化规则只会读取public级别的属性或标准getter方法，私有字段无对应getter时会直接跳过不序列化，这是该场景下最高发的原因。你可以本地写个最简单的单元测试，直接用项目里的ObjectMapper把实例化好的z对象转成JSON字符串，要是输出里b已经是null，直接就能定位是这个问题，不用绕去查WebClient配置。
检查DTO构造方法匹配性：你代码里直接调用全参构造new B("valueB1", "valueB2")、new Z("valueA1", b)实例化对象，如果类里没有显式定义对应参数列表的构造方法，或者缺省无参构造，部分Jackson版本处理嵌套对象序列化/反序列化时会出现属性赋值异常。另外要确认全参构造的参数顺序和字段声明顺序完全一致，避免传参错位导致b字段实际赋值就是null。
排查WebClient的编码器配置：确认你使用的client1实例绑定的JSON编码器是正常工作的，没有自定义的序列化规则过滤嵌套对象。比如如果自定义了ObjectMapper的属性过滤策略、全局命名策略，可能会导致b字段被忽略、或者序列化后的字段名和DTO定义不匹配，服务端解析不到就会映射为null——不过这种情况一般a字段也会出现解析异常，优先级低于前两项。

对应解决方法

最快修复方案：给两个DTO补上所有字段的public getter、setter方法，以及无参构造。如果项目里用了Lombok，直接在类上加@Data注解即可，不用手写冗余方法，示例：

import lombok.Data;

@Data
public class B {
    private String b1;
    private String b2;
}

@Data
public class Z {
    private String a;
    private B b;
}

如果不用Lombok，手动为每个字段编写标准的get、set方法就行，比如B类中添加public String getB1() { return b1; }、public void setB1(String b1) { this.b1 = b1; }这类方法，保证Jackson能读取到私有字段的值。

无getter场景的配置方案：如果不想为DTO写getter方法，可以修改WebClient绑定的ObjectMapper配置，开启私有字段访问权限：

ObjectMapper customMapper = new ObjectMapper();
// 允许直接访问所有级别的字段进行序列化，不需要getter
customMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
// 把这个customMapper传入WebClient的Jackson编码器即可

修复后先做本地验证：不要直接发请求调试，先在本地把实例化好的z对象序列化成JSON字符串，确认输出结构和预期一致，即{"a":"valueA1","b":{"b1":"valueB1","b2":"valueB2"}}，再发起请求就能解决b字段为null的问题。
额外优化点：你当前代码里的异常处理逻辑有缺陷，response.bodyToMono(String.class).map(Exception::new)不会把HTTP状态码、响应内容正确封装到异常信息里，调试时很难定位问题，建议调整为更合理的异常处理逻辑。

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