本文详解java中使用org.json库解析复杂嵌套json结构的正确方法，重点纠正数组索引误用、类型强转错误等常见问题，并提供可运行的代码示例与关键注意事项。
在Java中处理JSON数据时，一个常见误区是混淆JSONObject与JSONArray的层级关系，尤其当JSON结构包含数组嵌套对象、对象再嵌套属性时（如"user": [{ "info": { "name": "user 1" } }]）。原始代码中出现的异常（如JSONException: Value ... at 0 of type java.lang.Integer cannot be converted to JSONObject）正是源于对JSON语法和API行为的误解。
首先，需明确：JSON标准中对象的键必须为字符串，因此你提供的示例JSON片段：
{
"info": "info",
"user": [{
0: { "info": { "name": "user 1" } }
}]
}本身是非法的——0: 不是合法的JSON键（数字字面量不能直接作键，必须加双引号写成 "0"），且该结构意图模糊。实际开发中更典型的合法结构应为：
{
"info": "info",
"user": [
{
"info": {
"name": "user 1"
}
}
]
}✅ 正确解析步骤如下（基于 org.json:json 库）：
立即学习“Java免费学习笔记（深入）”；
- 将JSON字符串解析为 JSONObject；
- 通过 getJSONArray("user") 获取用户数组；
- 使用 getJSONObject(0) 获取数组中第一个元素（它是一个对象，不是数组！）；
- 再调用 getJSONObject("info") 进入内层对象；
- 最终用 getString("name") 提取值。
import org.json.*;
String json_string = "{\n" +
" \"info\": \"info\",\n" +
" \"user\": [\n" +
" {\n" +
" \"info\": {\n" +
" \"name\": \"user 1\"\n" +
" }\n" +
" }\n" +
" ]\n" +
"}";
JSONObject obj = new JSONObject(json_string);
JSONArray userArray = obj.getJSONArray("user");
// 注意：userArray.get(0) 返回的是 JSONObject，不是 JSONArray
JSONObject userInfo = userArray.getJSONObject(0).getJSONObject("info");
String name = userInfo.getString("name");
System.out.println(name); // 输出：user 1⚠️ 关键注意事项：
- ❌ 错误写法：.getJSONArray(0) → 数组第0项是对象，不是数组，强制转JSONArray会抛 JSONException；
- ❌ 错误写法：.getJSONObject("0") → 键名 "0" 在合法JSON中需显式存在，而本例中键是 "info"；
- ✅ 始终使用 getJSONObject() / getJSONArray() 而非泛型 get()，避免类型不匹配；
- ? 建议增加空值校验（尤其生产环境）：
if (userArray.length() > 0) { JSONObject firstUser = userArray.getJSONObject(0); if (firstUser.has("info")) { String name = firstUser.getJSONObject("info").getString("name"); } }
总结：JSON路径访问的核心在于严格匹配结构类型——先确认某字段是 object 还是 array，再选择对应 getXXX() 方法；切勿凭直觉假设嵌套层级。调试时可用 toString(2) 格式化打印中间对象，直观验证结构。
