如何将错误消息列表批量写入 TXT 或 JSON 文件

本文介绍如何将 java 中收集的错误消息列表(list)正确写入本地 txt 或 json 文件,解决空文件问题,并提供两种格式的完整实现方案。

在实际开发中,仅依赖日志框架(如 SLF4J + Log4j)自动落盘虽可行,但若业务逻辑已明确将错误信息统一缓存在 List 中(如 Util.errorMessages),则更推荐主动、可控地导出该列表——这能确保所有比对阶段捕获的错误 100% 写入目标文件,且格式、路径、编码完全由代码掌控。

以下是基于您现有结构的推荐实现(无需修改 Util 类的核心逻辑,仅增强导出能力):

✅ 正确写入 TXT 文件(按行保存,UTF-8 安全)

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.List;

public class ErrorExporter {
    public static void writeErrorsToTxt(List errors, String fileName) throws IOException {
        Path path = Paths.get(fileName); // 默认为当前工作目录,如需绝对路径可传入完整路径
        Files.write(path, errors, java.nio.charset.StandardCharsets.UTF_8);
    }
}

在 MyClass.main() 中调用:

public void main() {
    compare(source, target); // 确保传入参数

    try {
        // 写入当前目录下的 errors.txt
        ErrorExporter.writeErrorsToTxt(util.errorMessages, "errors.txt");
        System.out.println("✅ 错误日志已保存至 errors.txt");
    } catch (IOException e) {
        logger.error("写入错误文件失败", e);
    }
}
⚠️ 注意:您原代码中误将 ByteArrayOutputStream 当作数据源,但该流始终为空(未向其中写入任何内容),导致文件为空。应直接操作 errorMessages 列表本身。

✅ 写入 JSON 文件(结构化、易解析)

若需后续被 Python/JS 等读取,推荐生成标准 JSON 数组:

import com.fasterxml.jackson.databind.ObjectMapper;

public class ErrorExporter {
    private static final ObjectMapper mapper = new ObjectMapper();

    public static void writeErrorsToJson(List errors, String fileName) throws IOException {
        Path path = Paths.get(fileName);
        mapper.writeValue(path.toFile(), errors); // 自动序列化为 ["msg1","msg2",...]
    }
}

使用前添加 Jackson 依赖(Maven):


    com.fasterxml.jackson.core
    jackson-databind
    2.15.3

? 关键要点总结

  • 路径确认:Paths.get("errors.txt") 基于 JVM 启动时的 user.dir(即当前工作目录),可通过 System.getProperty("user.dir") 打印验证;
  • 线程安全:若 Util 实例被多线程共享,errorMessages 需改为 Collections.synchronizedList(n

    ew ArrayList());
  • 清空策略:导出后建议调用 util.errorMessages.clear(),避免重复写入历史错误;
  • 异常处理:务必捕获 IOException 并记录,防止静默失败;
  • 替代方案:如坚持用 FileWriter,请确保使用 try-with-resources 并逐行写入:
    try (FileWriter w = new FileWriter("errors.txt", StandardCharsets.UTF_8)) {
        for (String msg : util.errorMessages) {
            w.write(msg + System.lineSeparator());
        }
    }

通过以上方式,您即可稳定、清晰地将全部错误消息导出为可读 TXT 或结构化 JSON,彻底规避空文件问题。