本文详解如何在 java 中正确向 json 文件添加新玩家数据，解决因误用文件追加模式（append mode）导致的 json 结构重复、键重复及解析失败问题，并提供完整、健壮的读-改-写实现方案。
在 Java 中操作 JSON 文件时，一个常见但极易被忽视的错误是：对同一文件同时执行“读取”和“追加写入”（FileOutputStream(file, true)）。正如您当前代码所示：
PrintStream printStream = new PrintStream(new FileOutputStream("data.json", true));该 true 参数启用追加模式——每次调用 printStream.println(jsonObject) 都会将整个 JSON 对象（含 "players": [...]）作为新行追加到文件末尾，而非覆盖或更新原有内容。这正是您观察到文件中出现多个独立 { "players": [...] } 块（非法 JSON 流）的根本原因：JSON 标准要求单个文件必须是一个且仅一个合法的 JSON 值（如一个对象或数组），而多对象并列（如 {}{}）是语法错误，后续解析必然失败。
✅ 正确做法是采用 “读取 → 修改内存中 JSON 结构 → 全量覆盖写入” 的三步原子流程：
✅ 正确实现步骤（推荐使用 org.json 库）
import org.json.*;
import java.io.*;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.List;
public void addPlayer(PlayerManager playerManager) {
File file = new File("data.json");
JSONObject jsonObject;
// 1. 读取现有 JSON（若文件不存在或为空，则初始化空对象）
if (file.exists() && file.length() > 0) {
try {
String content = Files.readString(Paths.get(file.getAbsolutePath()));
jsonObject = new JSONObject(content);
} catch (IOException | JSONException e) {
System.err.println("读取 JSON 失败，将重建文件: " + e.getMessage());
jsonObject = new JSONObject();
}
} else {
jsonObject = new JSONObject();
}
// 2. 确保 "players" 数组存在（若无则创建）
JSONArray playersArray = jsonObject.optJSONArray("players");
if (playersArray == null) {
playersArray = new JSONArray();
jsonObject.put("players", playersArray);
}
// 3. 批量添加玩家（从 PlayerManager 获取）
List dataplayer = playerManager.getPlayersList();
for (Players player : dataplayer) {
JSONObject playerObj = new JSONObject();
playerObj.put("name", player.getName())
.put("team", player.getTeam().toString())
.put("level", player.getLevel())
.put("experiencePoints", player.getExperiencePoints())
.put("current_Energy", player.getCurrentEnergy());
playersArray.put(playerObj);
}
// 4. 【关键】全量覆盖写入（非追加！）
try (FileWriter writer = new FileWriter(file)) {
writer.write(jsonObject.toString(2)); // toString(2) 启用缩进，提升可读性
writer.flush();
System.out.println("✅ 玩家数据已成功更新至 data.json");
} catch (IOException e) {
System.err.println("❌ 写入 JSON 文件失败: " + e.getMessage());
e.printStackTrace();
}
} ⚠️ 关键注意事项
- 严禁混用读/写句柄：不要一边用 FileReader 读，一边用 FileOutputStream(..., true) 追加写同一个文件。
- 使用 FileWriter 替代 PrintStream：FileWriter 默认覆盖模式，语义更清晰；若需格式化输出，JSONObject.toString(indentFactor) 是最佳选择。
- 异常防御要强：optJSONArray() 比 getJSONArray() 更安全（不抛异常），配合 null 检查可避免 JSONException。
- 考虑线程安全：若多线程调用 addPlayer()，需加同步块或使用 ReentrantLock，防止并发写入冲突。
- 生产环境建议升级：对于复杂 JSON 操作，推荐使用 Jackson 或 Gson，它们提供更完善的序列化/反序列化、类型安全及性能优化。
✅ 总结
您遇到的“重复 key”现象本质是文件写入模式误用引发的 JSON 结构污染，而非逻辑判断缺陷。修复核心在于：放弃追加（append），拥抱覆盖（overwrite），并始终遵循「先读入内存 → 在内存中修改 → 一次性全量写回」的黄金流程。如此，您的 data.json 将始终保持标准、有效、可解析的单对象结构，"players" 数组也能稳定累积新增玩家数据。
立即学习“Java免费学习笔记（深入）”；
