本文详解如何在 android 中正确解析形如 {"users":[{...},{...}]} 的嵌套 json 数据，涵盖从顶层 jsonobject 提取 jsonarray、遍历对象及安全获取字段值的完整流程，并提供健壮的 java 示例代码与关键注意事项。
本文详解如何在 android 中正确解析形如 {"users":[{...},{...}]} 的嵌套 json 数据，涵盖从顶层 jsonobject 提取 jsonarray、遍历对象及安全获取字段值的完整流程，并提供健壮的 java 示例代码与关键注意事项。
在 Android 开发中，解析服务器返回的 JSON 数据是网络请求后的核心环节。初学者常误将整个 JSON 字符串直接当作 JSONArray 处理，导致 JSONException: Value ... of type org.json.JSONObject cannot be converted to JSONArray 异常——这正是原始代码中 new JSONArray(s) 报错的根本原因：该 JSON 响应是一个顶层为 JSONObject 的结构，其内部 "users" 字段才真正对应一个 JSONArray。
正确的解析逻辑需分三步进行：
- 先解析顶层 JSONObject：使用 new JSONObject(jsonString) 构造根对象；
- 从中提取命名数组：调用 getJSONArray("users") 获取目标数组；
- 遍历 JSONArray 并解析每个 JSONObject：通过 getJSONObject(i) 获取单个用户对象，再调用 getString()、getInt() 等方法提取字段。
以下是经过优化、生产可用的示例代码（适配 onPostExecute(String) 场景）：
@Override
protected void onPostExecute(String response) {
super.onPostExecute(response);
if (response == null || response.trim().isEmpty()) {
Log.e("JSONParse", "Empty or null response received");
return;
}
try {
// Step 1: Parse root JSONObject
JSONObject root = new JSONObject(response);
// Step 2: Extract "users" JSONArray
JSONArray usersArray = root.getJSONArray("users");
// Step 3: Iterate and extract data safely
StringBuilder usernames = new StringBuilder();
for (int i = 0; i < usersArray.length(); i++) {
JSONObject user = usersArray.getJSONObject(i);
int id = user.getInt("id");
String username = user.optString("username", "N/A"); // 防空安全
String emailHtml = user.optString("email", ""); // 注意：此字段含 HTML 标签
// 可选：使用 Html.fromHtml() 清洗邮箱（Android 6.0+ 推荐 Html.fromHtml(str, FROM_HTML_MODE_COMPACT)）
// String emailText = Html.fromHtml(emailHtml, Html.FROM_HTML_MODE_COMPACT).toString();
Log.d("User", String.format("ID:%d, Username:%s, Email:%s", id, username, emailHtml));
usernames.append(username).append("\n");
}
textView.setText(usernames.toString().trim());
} catch (JSONException e) {
Log.e("JSONParse", "Failed to parse JSON", e);
textView.setText("解析失败：" + e.getMessage());
}
}✅ 关键注意事项：
- 永远不要跳过顶层对象：本例中 {"users":[...]} 是 JSONObject，不是 JSONArray；直接 new JSONArray(s) 必然崩溃。
- 优先使用 optXXX() 方法：如 optString("username", "default")，避免因字段缺失导致 JSONException；仅当确认字段必存在时才用 getString()。
- 注意 HTML 转义内容：示例 JSON 中的 email 字段包含 标签（Cloudflare 邮箱保护），若需纯文本邮箱，请结合 Html.fromHtml() 解析并提取 href 或 textContent。
- 异步线程安全：textView.setText() 必须在主线程执行（onPostExecute 已满足），切勿在子线程中更新 UI。
- 推荐升级方案：现代项目建议使用 Gson 或 Moshi 配合数据类（POJO）实现自动映射，大幅提升可维护性与类型安全性。
掌握这一嵌套解析模式，即可从容应对绝大多数 REST API 返回的 JSON 结构，为构建稳定网络层打下坚实基础。
