File Writer无法写入已有JSON文件，如何排查修复？

可能原因及处理方式 #

• 路径有效性问题：先确认resourceHelper.getFilePath(DOCUMENT_PATH2)返回的路径是否正确。直接打印path变量值，检查是否存在拼写错误、指向了只读目录，或是路径对应的文件夹根本不存在。
• Gson序列化异常：别默认gson.toJson(documentToSave)一定生成了有效内容，先把序列化结果打印出来验证：

  String jsonContent = gson.toJson(documentToSave);
  System.out.println("序列化结果：" + jsonContent);
  

  如果输出为空或异常，说明是对象序列化环节出了问题，比如对象有循环引用、未给Gson配置对应序列化规则。
• 文件权限问题：手动在目标路径创建一个文件，验证是否有写入权限。Linux/macOS下注意目录的读写权限，Windows下检查文件是否被其他进程占用。
• 资源关闭不规范：改用try-with-resources语法，确保Writer资源自动关闭，避免手动调用close()时可能出现的遗漏：

  String path = resourceHelper.getFilePath(DOCUMENT_PATH2);
  Gson gson = new GsonBuilder().setPrettyPrinting().create();
  try (BufferedWriter writer = new BufferedWriter(new FileWriter(path))) {
      writer.write(gson.toJson(documentToSave));
  } catch (IOException e) {
      e.printStackTrace();
  }
  

• 异常被吞掉：检查Files.write的异常处理逻辑，该方法会抛出IOException，如果没捕获可能被上层代码吞掉，导致你误以为无异常。补全异常捕获：

  try {
      Files.write(Paths.get(path), new Gson().toJson(documentToSave).getBytes(StandardCharsets.UTF_8));
  } catch (IOException e) {
      e.printStackTrace();
  }
  

额外验证步骤 #

用一个简单测试对象（比如new HashMap<String, String>(){{put("test", "content");}}）替换documentToSave执行写入，看是否能正常生成文件，以此排除对象本身的序列化问题。

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