詳解如何快速定位和解決JSON錯(cuò)誤(以Protobuf的JsonFormat.ParseException為例)
一、問題背景
在一次日常開發(fā)中，我們的系統(tǒng)日志中出現(xiàn)了如下錯(cuò)誤信息：
2025-03-03 18:02:29.840 | ERROR | http-nio-8066-exec-1 | cn.ysx.service.openapi.impl.XinDuoAdServiceImpl | 獲取渠道廣告請(qǐng)求發(fā)送失敗: com.googlecode.protobuf.format.JsonFormat$ParseException: 1:362: Expected string. at com.googlecode.protobuf.format.JsonFormat$Tokenizer.parseException(JsonFormat.java:765) at com.googlecode.protobuf.format.JsonFormat$Tokenizer.consumeString(JsonFormat.java:715) at com.googlecode.protobuf.format.JsonFormat.handlePrimitive(JsonFormat.java:1059) ...
從錯(cuò)誤日志中可以看出，問題出在 JsonFormat.ParseException，具體原因是程序在解析JSON數(shù)據(jù)時(shí)，期望得到一個(gè)字符串，但實(shí)際數(shù)據(jù)不符合預(yù)期。接下來(lái)，我們將詳細(xì)分析如何定位和解決這個(gè)問題。
二、問題分析
1. 錯(cuò)誤日志解讀
首先，我們需要從錯(cuò)誤日志中提取關(guān)鍵信息：
- 錯(cuò)誤類型：
com.googlecode.protobuf.format.JsonFormat$ParseException - 錯(cuò)誤信息：
Expected string. - 錯(cuò)誤位置：第1行的第362個(gè)字符處
- 調(diào)用棧：錯(cuò)誤發(fā)生在
cn.ysx.service.openapi.impl.XinDuoAdServiceImpl.getAdvertising方法的第279行
通過這些信息，我們可以初步判斷問題是由于JSON數(shù)據(jù)格式不正確導(dǎo)致的。
2. 可能的原因
- JSON數(shù)據(jù)格式錯(cuò)誤：某個(gè)字段的值應(yīng)該是字符串，但實(shí)際是其他類型（如數(shù)字、布爾值等）。
- 數(shù)據(jù)源問題：如果JSON數(shù)據(jù)是從外部接口獲取的，可能是接口返回的數(shù)據(jù)格式不正確。
- 代碼邏輯問題：在生成或解析JSON數(shù)據(jù)時(shí)，代碼邏輯可能存在缺陷。
三、問題定位
1. 查看調(diào)用棧
從調(diào)用棧中可以看到，錯(cuò)誤發(fā)生在 XinDuoAdServiceImpl.getAdvertising 方法的第279行。我們需要查看該方法的代碼，找到解析JSON數(shù)據(jù)的部分。
假設(shè)代碼如下：
public void getAdvertising() {
String jsonData = getJsonDataFromSomewhere(); // 獲取JSON數(shù)據(jù)
try {
JsonFormat.merge(jsonData, builder); // 解析JSON數(shù)據(jù)
} catch (JsonFormat.ParseException e) {
logger.error("解析JSON數(shù)據(jù)失敗", e);
throw new RuntimeException("解析JSON數(shù)據(jù)失敗", e);
}
}
2. 打印JSON數(shù)據(jù)
為了進(jìn)一步分析問題，我們可以在解析之前打印出JSON數(shù)據(jù)：
public void getAdvertising() {
String jsonData = getJsonDataFromSomewhere(); // 獲取JSON數(shù)據(jù)
logger.info("Received JSON data: {}", jsonData); // 打印JSON數(shù)據(jù)
try {
JsonFormat.merge(jsonData, builder); // 解析JSON數(shù)據(jù)
} catch (JsonFormat.ParseException e) {
logger.error("解析JSON數(shù)據(jù)失敗", e);
throw new RuntimeException("解析JSON數(shù)據(jù)失敗", e);
}
}
通過日志輸出，我們可以查看實(shí)際的JSON數(shù)據(jù)，檢查是否有格式問題。
3. 檢查數(shù)據(jù)源
如果JSON數(shù)據(jù)是從外部接口獲取的，我們需要檢查該接口的返回?cái)?shù)據(jù)是否正確?？梢允褂霉ぞ撸ㄈ鏟ostman或curl）手動(dòng)請(qǐng)求接口，查看返回的JSON數(shù)據(jù)。
例如，使用curl命令：
curl -X GET http://example.com/api/getAdData
如果返回的數(shù)據(jù)格式不正確，可能需要與接口提供方溝通，確保返回的數(shù)據(jù)格式符合預(yù)期。
四、問題解決
1. 修復(fù)JSON數(shù)據(jù)格式
假設(shè)我們從日志中看到的JSON數(shù)據(jù)如下：
{
"adId": 12345,
"adName": "Test Ad",
"adTarget": "http://example.com",
"adType": 1
}
根據(jù)錯(cuò)誤提示，程序期望在第1行的第362個(gè)字符處得到一個(gè)字符串。我們需要檢查JSON數(shù)據(jù)中是否有字段的值類型不正確。
例如，如果 adType 字段的值應(yīng)該是字符串，但實(shí)際是數(shù)字，我們可以將其改為字符串：
{
"adId": 12345,
"adName": "Test Ad",
"adTarget": "http://example.com",
"adType": "1"
}
2. 修改代碼邏輯
如果問題是由于代碼邏輯導(dǎo)致的，我們需要修改生成或解析JSON數(shù)據(jù)的邏輯。例如，確保所有字段的值類型符合預(yù)期：
public String generateJsonData() {
JsonObject jsonObject = new JsonObject();
jsonObject.addProperty("adId", 12345);
jsonObject.addProperty("adName", "Test Ad");
jsonObject.addProperty("adTarget", "http://example.com");
jsonObject.addProperty("adType", "1"); // 確保adType是字符串
return jsonObject.toString();
}
3. 添加數(shù)據(jù)校驗(yàn)
為了防止類似問題再次發(fā)生，我們可以在解析JSON數(shù)據(jù)之前添加數(shù)據(jù)校驗(yàn)邏輯：
public void getAdvertising() {
String jsonData = getJsonDataFromSomewhere(); // 獲取JSON數(shù)據(jù)
logger.info("Received JSON data: {}", jsonData); // 打印JSON數(shù)據(jù)
// 數(shù)據(jù)校驗(yàn)
if (!isValidJson(jsonData)) {
logger.error("JSON數(shù)據(jù)格式不正確");
throw new RuntimeException("JSON數(shù)據(jù)格式不正確");
}
try {
JsonFormat.merge(jsonData, builder); // 解析JSON數(shù)據(jù)
} catch (JsonFormat.ParseException e) {
logger.error("解析JSON數(shù)據(jù)失敗", e);
throw new RuntimeException("解析JSON數(shù)據(jù)失敗", e);
}
}
private boolean isValidJson(String jsonData) {
try {
new JsonParser().parse(jsonData);
return true;
} catch (JsonSyntaxException e) {
return false;
}
}
五、總結(jié)
通過以上步驟，我們成功定位并解決了JSON解析錯(cuò)誤?？偨Y(jié)一下，解決類似問題的關(guān)鍵步驟包括：
- 分析錯(cuò)誤日志：提取關(guān)鍵信息，確定問題類型和位置。
- 打印和檢查數(shù)據(jù)：通過日志輸出或工具檢查JSON數(shù)據(jù)的格式。
- 修復(fù)數(shù)據(jù)或代碼：根據(jù)問題原因，修復(fù)JSON數(shù)據(jù)格式或代碼邏輯。
- 添加數(shù)據(jù)校驗(yàn)：防止類似問題再次發(fā)生。
在實(shí)際開發(fā)中，JSON解析錯(cuò)誤是一個(gè)常見但容易被忽視的問題。通過本文的案例分析和解決方案，希望能夠幫助開發(fā)者更好地應(yīng)對(duì)類似問題，提高系統(tǒng)的穩(wěn)定性和可靠性。
以上就是詳解如何快速定位和解決JSON錯(cuò)誤(以Protobuf的JsonFormat.ParseException為例)的詳細(xì)內(nèi)容，更多關(guān)于定位和解決JSON錯(cuò)誤的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
Spring Boot Maven Plugin打包異常解決方案
這篇文章主要介紹了Spring Boot Maven Plugin打包異常解決方案,文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-11-11
JAVA實(shí)現(xiàn) SpringMVC方式的微信接入、實(shí)現(xiàn)簡(jiǎn)單的自動(dòng)回復(fù)功能
這篇文章主要介紹了JAVA實(shí)現(xiàn) SpringMVC方式的微信接入、實(shí)現(xiàn)簡(jiǎn)單的自動(dòng)回復(fù)功能的相關(guān)資料,非常不錯(cuò)具有參考借鑒價(jià)值，需要的朋友可以參考下2016-11-11
這篇文章主要介紹了Spring中使用ehcache緩存的方法及原理詳解,ehcache具有很強(qiáng)的靈活性,提供了LRU、LFU和FIFO緩存淘汰算法,Ehcache 1.2引入了最近最少使用、最久未使用和先進(jìn)先 出緩存淘汰算法, 構(gòu)成了完整的緩存淘汰算法,,需要的朋友可以參考下2024-01-01
這篇文章主要介紹了如何處理器攔截器(HandlerInterceptor)問題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2023-07-07
Java中JSON字符串與java對(duì)象的互換實(shí)例詳解
這篇文章主要介紹了在java中，JSON字符串與java對(duì)象的相互轉(zhuǎn)換實(shí)例詳解，非常不錯(cuò)，具有參考借鑒價(jià)值,需要的朋友可以參考下2016-08-08
Spring定時(shí)任務(wù)關(guān)于@EnableScheduling的用法解析
這篇文章主要介紹了Spring定時(shí)任務(wù)關(guān)于@EnableScheduling的用法，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2023-06-06
Java中replace與replaceAll的區(qū)別與測(cè)試
replace和replaceAll是JAVA中常用的替換字符的方法,下面這篇文章主要給大家介紹了關(guān)于Java中replace與replaceAll的區(qū)別與測(cè)試,文中通過實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2022-09-09
Vector?類實(shí)現(xiàn)了一個(gè)動(dòng)態(tài)數(shù)組。和?ArrayList?很相似，但是兩者是不同的：Vector?是同步訪問的；Vector?包含了許多傳統(tǒng)的方法，這些方法不屬于集合框架2022-03-03
使用spring-boot-admin對(duì)spring-boot服務(wù)進(jìn)行監(jiān)控的實(shí)現(xiàn)方法
這篇文章主要介紹了使用spring-boot-admin對(duì)spring-boot服務(wù)進(jìn)行監(jiān)控的實(shí)現(xiàn)方法,需要的朋友可以參考下2018-02-02
Java采用循環(huán)鏈表結(jié)構(gòu)求解約瑟夫問題
這篇文章主要介紹了Java采用循環(huán)鏈表結(jié)構(gòu)求解約瑟夫問題的解決方法,是很多Java面試環(huán)節(jié)都會(huì)遇到的經(jīng)典考題,這里詳細(xì)給出了約瑟夫問題的原理及Java解決方法,是非常經(jīng)典的應(yīng)用實(shí)例,具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2014-12-12