Jackson 可通过启用 ACCEPT_EMPTY_STRING_AS_NULL_OBJECT 特性，将 JSON 中的空字符串 "" 视为 null，再结合字段默认初始化或 @JsonSetter 等机制，最终安全映射为空 List，避免反序列化异常并保持语义一致性。

jackson 可通过启用 `accept_empty_string_as_null_object` 特性，将 json 中的空字符串 `""` 视为 `null`，再结合字段默认初始化或 `@jsonsetter` 等机制，最终安全映射为空 `list`，避免反序列化异常并保持语义一致性。

在使用 Jackson 反序列化第三方 JSON 数据时，常遇到数据格式不规范的问题：本该是 JSON 数组（如 "courseNames": []）的字段，却被错误地传为 JSON 字符串（如 "courseNames": ""）。若 POJO 中对应字段为 List，默认情况下 Jackson 会抛出 MismatchedInputException —— 因为无法将空字符串直接转为 List。

最简洁、健壮且无需自定义反序列化器的解决方案，是启用 Jackson 内置的反序列化特性：

ObjectMapper mapper = new ObjectMapper();
mapper.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);

该特性会使 Jackson 将任意空字符串 ""（针对非基本类型字段）视为 null，后续再由字段默认值或 Jackson 的空值处理逻辑接管。

✅ 配合字段初始化，即可自然获得空列表：

Node.js 可靠编程

Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词：Node.js 开发、async/await、流处理、性能优化、安全编码。

下载

立即学习“Java免费学习笔记（深入）”；

@Data
public class Student {
    // 默认初始化确保 null → 空 ArrayList
    private List<String> courseNames = new ArrayList<>();
}

此时，以下三种 JSON 输入均能正确解析：

• { "courseNames": ["abc", "xyz"] } → 含两个元素的列表
• { "courseNames": [] } → 空列表（标准行为）
• { "courseNames": "" } → 触发 ACCEPT_EMPTY_STRING_AS_NULL_OBJECT → null → 被字段默认值覆盖为 new ArrayList()

⚠️ 注意事项：

• 该特性对所有复杂类型（List, Map, 自定义 POJO 等）生效，需确保全局语义一致；若仅需对特定字段生效，推荐使用 @JsonSetter(nulls = Nulls.AS_EMPTY)（Jackson 2.12+）：

  @JsonSetter(nulls = Nulls.AS_EMPTY)
  public void setCourseNames(List<String> courseNames) {
      this.courseNames = courseNames;
  }

• 若使用 Lombok 的 @Data 或 @Setter，注意 @Setter 不会自动处理 null → 需显式添加 @JsonSetter 或保留字段初始化。
• 该特性不改变非空字符串的行为（如 "abc" 仍会报错），因此不会引入意外副作用。

总结：优先使用 ACCEPT_EMPTY_STRING_AS_NULL_OBJECT + 字段默认初始化 组合，代码简洁、可维护性强，且完全规避了手写 JsonDeserializer 带来的耦合与测试成本。