SpringBoot中为@RequestBody绑定校验字段设置默认值的方案咨询

下面是几种经过验证的替代实现方式，可根据你的业务场景选择：

方案1：使用Jackson的注入功能实现配置值填充 #

SpringBoot默认使用Jackson做JSON反序列化，你可以通过@JacksonInject注解让Jackson在反序列化@RequestBody对象时，自动将Spring容器中的配置值注入到POJO中：

1. 首先在配置类中暴露配置字段，让Jackson的注入上下文可以读取到配置值：

// 配置类
@Configuration
public class JacksonConfig {
    @Value("${field1.default}")
    private String field1Default;

    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 将配置值注册到Jackson的注入上下文中
        mapper.setInjectableValues(new InjectableValues.Std()
                .addValue("field1Default", field1Default)
        );
        return mapper;
    }
}

2. 修改DataObject类，去掉@Component注解，改为普通POJO，使用@JacksonInject注入默认值：

@Data
public class DataObject {
    @JacksonInject("field1Default")
    @JsonIgnore // 避免请求参数覆盖默认值字段
    private String field1Default;
    
    private String field1;

    public String getField1() {
        return field1 == null ? field1Default : field1;
    }
}

这种方式完全不需要修改Controller逻辑，反序列化时自动完成默认值注入，适合单个/少量字段的场景。

方案2：使用RequestBodyAdvice全局统一处理 #

如果有大量类需要填充默认值，推荐使用Spring的RequestBodyAdvice做全局切面处理，在@RequestBody参数绑定完成后统一填充默认值：

@ControllerAdvice
public class DefaultValueInjectAdvice implements RequestBodyAdvice {
    @Value("${field1.default}")
    private String field1Default;

    @Override
    public boolean supports(MethodParameter methodParameter, Type targetType, Class<? extends HttpMessageConverter<?>> converterType) {
        // 只处理包含DataObject的请求类，或者自定义注解标记需要填充默认值的类
        return MyContract.class.isAssignableFrom((Class<?>) targetType);
    }

    @Override
    public Object afterBodyRead(Object body, HttpInputMessage inputMessage, MethodParameter parameter, Type targetType, Class<? extends HttpMessageConverter<?>> converterType) {
        if (body instanceof MyContract contract) {
            DataObject data = contract.getDataObject();
            if (data != null && data.getField1() == null) {
                data.setField1(field1Default);
            }
        }
        return body;
    }

    // 其余接口默认实现即可
    @Override
    public HttpInputMessage beforeBodyRead(HttpInputMessage inputMessage, MethodParameter parameter, Type targetType, Class<? extends HttpMessageConverter<?>> converterType) throws IOException {
        return inputMessage;
    }

    @Override
    public Object handleEmptyBody(Object body, HttpInputMessage inputMessage, MethodParameter parameter, Type targetType, Class<? extends HttpMessageConverter<?>> converterType) {
        return body;
    }
}

这种方式适合全局批量处理，不需要修改POJO类的代码，扩展性更强。

方案3：业务层手动填充 #

如果你的DataObject除了请求绑定之外，其他代码位置也经常需要手动创建实例，可以将默认值封装到一个配置Bean中，需要的时候手动调用填充：

// 配置类，统一管理所有默认值
@Component
public class DefaultValueConfig {
    @Value("${field1.default}")
    public String field1Default;
}

// 业务类中使用
@Service
public class MyService {
    @Autowired
    private DefaultValueConfig defaultValueConfig;

    public void process(DataObject data) {
        if (data.getField1() == null) {
            data.setField1(defaultValueConfig.field1Default);
        }
        // 后续业务逻辑
    }
}

这种方式最灵活，适合填充逻辑复杂、不同场景默认值不同的情况。

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