如何正确为Spring接口RequestBody请求体字段定义默认值？

@Schema(defaultValue = "ba")不生效的核心原因是：
@Schema是OpenAPI/Swagger的文档生成注解，所有属性仅用于生成接口文档说明，不会介入Spring的请求参数绑定、JSON反序列化流程。配置的defaultValue只会在Swagger UI页面上展示参数默认值提示，不会在调用方未传参时实际给字段赋值。
你之前用的@RequestParam(defaultValue = "xx")能生效，是因为@RequestParam是Spring Web原生的参数绑定注解，其defaultValue属性本身就属于参数绑定逻辑的一部分，和@Schema属于完全不同的体系。

你提到的两种方案都是可行的，适用场景有区别：

• 字段直接初始化：即String foo = "ba";的写法，是Spring生态下最通用的静态默认值最佳实践。
  Spring默认使用Jackson做JSON反序列化，当请求体未携带对应字段时，Jackson不会主动把字段覆盖为null，会直接保留类加载时设置的字段初始值。
  这种写法对final字段同样生效，只要在定义final字段时直接赋值即可：

  public class MyRequest {
    // final字段直接初始化完全可用，未传参时默认值正常生效
    private final String foo = "ba";
  }
  

  唯一需要注意的是，如果请求类使用了Lombok的@Builder注解，需要在有默认值的字段上加@Builder.Default，避免Builder构建对象时把初始值覆盖为null；如果同时用了@AllArgsConstructor，也要确保构造器逻辑不会覆盖默认初始值。
  如果需要让Swagger文档同步展示默认值，搭配@Schema(defaultValue = "ba")使用即可，两者互不冲突。
• Controller层手动判空赋值：适合默认值是动态值的场景，比如默认值需要从配置文件读取、根据请求其他字段计算得到。缺点是字段较多时会产生大量重复判空代码，维护成本高。

如果有批量设置默认值的需求，也可以使用Jackson的null值处理配置，单字段场景下写法比直接初始化繁琐，没有特殊需求不推荐：

public class MyRequest {
  private String foo;

  // 反序列化时遇到null值跳过setter赋值，保留默认值
  @JsonSetter(nulls = Nulls.SKIP)
  public void setFoo(String foo) {
    this.foo = foo;
  }

  // 无参构造里初始化默认值
  public MyRequest() {
    this.foo = "ba";
  }
}

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