如何在 Java 中正确遍历嵌套的 JSON 数据结构

本文详解使用 org.json 库安全访问嵌套 json 中的 jsonarray 与 jsonobject，重点解决因索引越界、重复构造对象及类型误用导致的 `jsonarray initial value should be a string or collection or array` 异常。

在 Java 中解析嵌套 JSON（如 JSONObject → JSONArray → JSONObject）是常见需求，但初学者易因对 org.json API 理解偏差而引发运行时异常。你遇到的错误 JSONArray initial value should be a string or collection or array，根本原因在于 对已有 JSONArray 对象进行了冗余的二次构造：

JSONArray data = new JSONArray(JSON.getJSONArray("data")); // ❌ 错误！

JSON.getJSONArray("data") 已返回一个有效的 JSONArray 实例，再次用它作为参数调用 new JSONArray(...) 会触发内部类型校验失败——因为 JSONArray 构造器期望原始字符串、Collection 或数组，而非另一个 JSONArray。

✅ 正确做法是直接复用已解析的对象：

Favird No-Code Tools

无代码工具的聚合器

下载

JSONObject root = new JSONObject(content1.toString()); // 解析顶层 JSON
JSONArray data = root.getJSONArray("data"); // 直接获取，无需 new JSONArray(...)
for (int i = 0; i < data.length(); i++) {     // ⚠️ 注意：起始索引为 0，非 1；变量名应为 i，非 z
    JSONObject player = data.getJSONObject(i); // ✅ 直接获取子 JSONObject
    System.out.println(player.toString());
}

此外，还需注意以下关键细节：

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

• 循环边界：for 循环必须从 i = 0 开始，且条件为 i
• 避免重复包装：getJSONObject(i) 返回的就是 JSONObject，无需 new JSONObject(...) 再封装（这不仅低效，还可能因传入非字符串类型抛出异常）。
• 健壮性增强（推荐）：生产环境建议添加空值与类型检查：

if (root.has("data") && root.get("data") instanceof JSONArray) {
    JSONArray data = root.getJSONArray("data");
    for (int i = 0; i < data.length(); i++) {
        Object item = data.get(i);
        if (item instanceof JSONObject) {
            JSONObject player = (JSONObject) item;
            String name = player.optString("name", "Unknown"); // 安全读取字段
            System.out.println("Player: " + name);
        }
    }
}

• 关于“未命名”的玩家对象：JSON 数组中的元素本就是匿名的（按索引访问），这正是 getJSONObject(i) 设计的初衷——无需键名，通过位置即可精准定位每个玩家配置。

总结：掌握 org.json 的核心原则——“解析一次，复用对象；索引从零开始，拒绝冗余构造”，即可稳定高效地处理任意深度嵌套的 JSON 结构。