
本文详解如何使用原生 org.json 库正确解析多层嵌套 JSON,定位并提取如 Data[0].CaseData.CaseResult.RequestID 这类深层键值,避免因错误路径语法导致的 JSONException。
本文详解如何使用原生 org.json 库正确解析多层嵌套 json,定位并提取如 `data[0].casedata.caseresult.requestid` 这类深层键值,避免因错误路径语法导致的 jsonexception。
在调用 RESTful API 后,开发者常需从结构复杂的 JSON 响应中提取特定字段。但需注意:org.json 库不支持点号(.)或方括号([])组成的“路径字符串”直接访问(例如 "Data[0].CaseData.CaseResult.RequestID"),这正是你遇到 JSONException: JSONObject["..."] not found 的根本原因——get() 方法仅接受单一 key 名,而非嵌套路径。
正确的做法是逐级导航 JSON 结构,严格遵循其类型层次:JSONObject → JSONArray → JSONObject → … → String。以下为推荐实现(Java + org.json):
import org.json.*;
// 假设 response.getResponseText() 返回完整的 JSON 字符串
String json = response.getResponseText();
try {
JSONObject root = new JSONObject(json);
// 1. 获取 Data 数组(类型:JSONArray)
JSONArray dataArray = root.getJSONArray("Data");
// 2. 获取第一个元素(类型:JSONObject)
JSONObject firstItem = dataArray.getJSONObject(0);
// 3. 进入 CaseData 对象
JSONObject caseData = firstItem.getJSONObject("CaseData");
// 4. 进入 CaseResult 对象
JSONObject caseResult = caseData.getJSONObject("CaseResult");
// 5. 最终获取 RequestID 字符串
String requestId = caseResult.getString("RequestID");
System.out.println("Extracted RequestID: " + requestId);
// 输出:8C15473C0F7771F410928D5D91362B80
} catch (JSONException e) {
// 关键:始终捕获 JSONException,便于定位哪一层缺失
System.err.println("JSON parsing failed at: " + e.getMessage());
e.printStackTrace();
}
⚠️ 重要注意事项:
- 类型强校验:每一步都必须使用对应类型的方法(如 getJSONArray()、getJSONObject()),若实际 JSON 中该字段不存在或类型不符(例如期望对象却得到 null 或字符串),会立即抛出 JSONException;
- 空值与边界安全:生产环境建议增加判空逻辑,例如检查 dataArray.length() > 0、caseResult.has("RequestID") 等,避免运行时异常;
- 顶层 RequestID vs 内层 RequestID:本例中 JSON 同时存在两个 RequestID(根级 "RequestID":"29d2d52c-..." 和内层 "CaseResult" 中的),请根据业务需求明确目标路径;
- 替代方案提示:如项目允许引入第三方库,可考虑 Jackson(jsonNode.path("Data").get(0).path("CaseData").path("CaseResult").path("RequestID").asText())或 Gson(配合 JsonPath),它们原生支持路径表达式,大幅提升可读性与开发效率。
掌握逐层解析逻辑,不仅能解决当前问题,更是处理任意深度嵌套 JSON 的通用范式。











