当使用 json-simple 库解析 JSON 字符串时，若原始数据是 JSON 对象（如 {"key":"value"}），却强行强制转换为 JSONArray，将抛出 ClassCastException；必须先判断实际结构，再选择对应类型接收。

当使用 json-simple 库解析 json 字符串时，若原始数据是 json 对象（如 `{"key":"value"}`），却强行强制转换为 `jsonarray`，将抛出 `classcastexception`；必须先判断实际结构，再选择对应类型接收。

在 Java 中使用 org.json.simple 解析 JSON 时，一个常见误区是假设输入字符串“一定是数组”而直接强转：

JSONParser parse = new JSONParser();
JSONArray dataObject = (JSONArray) parse.parse(String.valueOf(informationString)); // ❌ 危险！

上述代码失败的根本原因在于：informationString 实际表示的是一个 JSON 对象（例如 {"name":"Alice","age":30}），而 JSONParser.parse() 返回的是泛型 Object，其运行时真实类型为 JSONObject。此时强制转型为 JSONArray 必然触发 ClassCastException。

✅ 正确做法是先解析为通用 Object，再根据实际结构安全转型：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

JSONParser parser = new JSONParser();
try {
    Object parsed = parser.parse(informationString); // 解析为 Object

    if (parsed instanceof JSONArray) {
        JSONArray array = (JSONArray) parsed;
        System.out.println("Parsed as JSONArray: " + array.size() + " elements");
        // 处理数组逻辑...
    } else if (parsed instanceof JSONObject) {
        JSONObject obj = (JSONObject) parsed;
        System.out.println("Parsed as JSONObject: keys = " + obj.keySet());
        // 处理对象逻辑...
    } else {
        throw new IllegalArgumentException("Unsupported JSON type: " + parsed.getClass().getSimpleName());
    }
} catch (ParseException e) {
    throw new RuntimeException("Invalid JSON format", e);
}

⚠️ 注意事项：

• 不要依赖 String.valueOf(informationString) —— 若 informationString 已是 String，该调用冗余且易引发误解；直接传入原始字符串即可。
• json-simple 不提供类型自动推导 API，务必手动 instanceof 判断。
• 生产环境建议搭配 try-catch 捕获 ParseException，避免因格式错误导致程序崩溃。
• 如需更健壮的 JSON 处理能力（如流式解析、Schema 验证），可考虑升级至 Jackson 或 Gson。

总结：JSON 解析不是“一锤定音”的强制转换，而是“先识别、后处理”的两步过程。尊重数据的实际结构，是避免 ClassCastException 的唯一可靠方式。