快捷導(dǎo)航

使用FastJSON解析JSON發(fā)生異常的踩坑記錄

更新時(shí)間：2025年09月08日 09:36:52 作者：tingyu

這篇文章主要為大家詳細(xì)介紹了使用FastJSON解析JSON發(fā)生異常的問(wèn)題原因分析以及對(duì)應(yīng)的解決方法,文章的示例代碼講解詳細(xì),感興趣的小伙伴可以了解下

前言

最近在開(kāi)發(fā)電子簽名項(xiàng)目時(shí)遇到了一個(gè)特別頭疼的問(wèn)題，系統(tǒng)在處理JSON數(shù)據(jù)時(shí)突然報(bào)錯(cuò)，錯(cuò)誤信息看起來(lái)很奇怪：syntax error : f。經(jīng)過(guò)一番排查，發(fā)現(xiàn)是FastJSON在處理特定數(shù)據(jù)時(shí)的一個(gè)坑。今天把這個(gè)問(wèn)題記錄下來(lái)，希望能幫到遇到類似問(wèn)題的朋友。

問(wèn)題現(xiàn)象

系統(tǒng)運(yùn)行得好好的，突然就報(bào)錯(cuò)了：

com.alibaba.fastjson2.JSONException: syntax error : f
at com.alibaba.fastjson2.JSONReaderUTF16.readBoolValue(JSONReaderUTF16.java:6426)
at com.alibaba.fastjson2.JSONReader.read(JSONReader.java:2164)
at com.alibaba.fastjson2.JSON.parse(JSON.java:67)
at com.alibaba.fastjson2.JSON.toJSON(JSON.java:3506)

看到這個(gè)錯(cuò)誤，第一反應(yīng)是：什么鬼？JSON格式?jīng)]問(wèn)題啊，怎么就解析不了了？

問(wèn)題代碼

出問(wèn)題的代碼很簡(jiǎn)單，就是想從返回的數(shù)據(jù)中提取一個(gè)字段：

// 這行代碼出問(wèn)題了
com.alibaba.fastjson2.JSONObject contentJson = 
    (com.alibaba.fastjson2.JSONObject) com.alibaba.fastjson2.JSON.toJSON(invoke.getData().getContent());

String edocId = null;
edocId = contentJson.getString("formRecordId");

if (StringUtils.isBlank(edocId)) {
    edocId = contentJson.getString("formRecordCode");
}

數(shù)據(jù)分析

接口返回的JSON數(shù)據(jù)看起來(lái)完全正常：

{
    "id": 8745074954268373736,
    "startAccountId": -8901286526055593580,
    "generateType": null,
    "prevNodeId": 175688901899730,
    "formRecordId": 6003933439012269528,
    "pcPageParam": null,
    "dealTime": 0,
    "nodeName": "管理員",
    "formRecordCode": "6003933439012269528",
    "extLong1": 0,
    "overdueWorkingShow": null
}

乍一看沒(méi)什么問(wèn)題，但仔細(xì)觀察會(huì)發(fā)現(xiàn)，formRecordId 的值是一個(gè)很大的數(shù)字：6003933439012269528。

問(wèn)題根源

經(jīng)過(guò)反復(fù)測(cè)試和分析，發(fā)現(xiàn)問(wèn)題出在FastJSON處理大數(shù)字時(shí)的一個(gè)坑：

大數(shù)字處理問(wèn)題：當(dāng)JSON中包含超出JavaScript安全整數(shù)范圍的數(shù)字時(shí)，F(xiàn)astJSON在某些情況下會(huì)出現(xiàn)解析異常
類型轉(zhuǎn)換問(wèn)題：直接使用 JSON.toJSON() 方法可能會(huì)觸發(fā)內(nèi)部的類型推斷機(jī)制，導(dǎo)致解析錯(cuò)誤
字符編碼問(wèn)題：在某些環(huán)境下，字符編碼也可能影響JSON解析

解決方案

方案一：避免使用 JSON.toJSON()

最直接的解決方法就是改變JSON處理方式：

// 原來(lái)的寫(xiě)法（有問(wèn)題）
com.alibaba.fastjson2.JSONObject contentJson = 
    (com.alibaba.fastjson2.JSONObject) com.alibaba.fastjson2.JSON.toJSON(invoke.getData().getContent());

// 改進(jìn)后的寫(xiě)法
String contentStr = com.seeyon.boot.util.JsonUtils.toJson(invoke.getData().getContent());
com.alibaba.fastjson2.JSONObject contentJson = com.alibaba.fastjson2.JSON.parseObject(contentStr);

方案二：統(tǒng)一使用Hutool工具類

既然FastJSON容易踩坑，不如換個(gè)更穩(wěn)定的工具：

// 使用Hutool的JSON工具
cn.hutool.json.JSONObject contentJson = new cn.hutool.json.JSONObject(invoke.getData().getContent());
String edocId = contentJson.getStr("formRecordId");
if (StrUtil.isBlank(edocId)) {
    edocId = contentJson.getStr("formRecordCode");
}

方案三：增加異常處理

無(wú)論用什么方案，都要加上異常處理，讓程序更健壯：

private String invokeGetEdocIdByAffairId(Long affairId) {
    // ... 前面的代碼省略
    
    try {
        // 使用更安全的JSON處理方式
        String contentStr = JsonUtil.toJsonStr(invoke.getData().getContent());
        cn.hutool.json.JSONObject contentJson = JSONUtil.parseObj(contentStr);
        
        String edocId = contentJson.getStr("formRecordId");
        if (StrUtil.isBlank(edocId)) {
            edocId = contentJson.getStr("formRecordCode");
        }
        
        log.info("成功提取edocId: {}", edocId);
        return edocId;
        
    } catch (Exception e) {
        log.error("解析JSON數(shù)據(jù)失敗，原始數(shù)據(jù): {}", 
                 invoke.getData().getContent(), e);
        return null;
    }
}