如何使用Jackson ObjectMapper向已有YAML文件追加条目

你当前调用的objectMapper.writeValue(new File(path), logItem)默认是全量覆盖写入模式，自然无法实现追加效果。另外先提个语法问题：你给出的目标YAML结构存在重复顶级item键，严格来说不符合YAML官方规范，常规解析器读取这类文件时只会保留最后一个item节点的数据，更合理的标准结构是用数组承载多条记录，格式如下：

items:
  - entityType: article
    entityId: 318 
    created: 1655282744819 
    user: "admin"
    title: "Morning" 
    eventType: "viewing"

  - entityType: event
    entityId: 339 
    created: 1655223444821 
    user: "admin"
    title: "Evening" 
    eventType: "editing"

方案1：标准YAML结构可靠实现（推荐） #

用「读取-追加-全量写回」的逻辑实现，不会产生格式错误，后续解析也不需要额外兼容，适合绝大多数业务场景，步骤如下：

• 写入前先判断目标文件是否存在
  • 文件不存在：初始化根结构，创建空的items数组，放入第一条实体记录后写入新文件
  • 文件已存在：先把已有YAML内容反序列化为内存对象，取出items数组，将新到的实体加入数组末尾，再全量序列化写回原文件
    核心实现代码（基于Jackson YAML扩展）：

// 初始化YAML序列化实例
ObjectMapper yamlMapper = new ObjectMapper(new YAMLFactory());
File targetFile = new File(yamlPath);
LogRoot logRoot;

// 加载已有内容
if (targetFile.exists()) {
    logRoot = yamlMapper.readValue(targetFile, LogRoot.class);
} else {
    logRoot = new LogRoot();
    logRoot.setItemList(new ArrayList<>());
}

// 追加新记录
logRoot.getItemList().add(newLogItem);

// 写回文件
yamlMapper.writeValue(targetFile, logRoot);

如果你的日志单文件大小会超过100M，这个方案会有一定的内存开销，可以按日期/大小拆分日志文件，避免单文件过大。

方案2：按自定义格式流式追加（不推荐） #

如果你必须保持每条记录单独以item:开头、不使用数组包裹的格式，可以直接用文件追加流，手动拼接格式后写入文件尾，核心代码如下：

// 先将单条实体序列化为YAML文本
String singleItemYaml = yamlMapper.writeValueAsString(newLogItem);
// 处理缩进，给每一行内容前加对应空格匹配格式要求
String formattedItem = singleItemYaml.lines()
        .map(line -> "        " + line)
        .collect(Collectors.joining(System.lineSeparator()));

// 以追加模式打开文件写入
try (FileWriter fw = new FileWriter(yamlPath, true);
     BufferedWriter bw = new BufferedWriter(fw)) {
    bw.write("    item:");
    bw.newLine();
    bw.write(formattedItem);
    bw.newLine();
    bw.newLine(); // 不同记录之间空一行
}

注意：这个方案生成的YAML存在重复键问题，后续读取解析时不能直接用常规ObjectMapper反序列化，需要自定义逐行解析逻辑，容错性差，非必要不使用。

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