詳解如何快速定位和解決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ù)期。接下來，我們將詳細(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ù)是否正確。可以使用工具（如Postman或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ò)誤。總結(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)文章
詳解SpringMVC重定向傳參數(shù)的實(shí)現(xiàn)
本篇文章主要介紹了詳解SpringMVC重定向傳參數(shù)的實(shí)現(xiàn)，我們可以使用重定向的方式，改變?yōu)g覽器的地址欄，防止表單因?yàn)樗⑿轮貜?fù)提交。有興趣的可以了解一下。2017-01-01
這篇文章介紹了Java設(shè)計(jì)模式之解釋器模式，文中通過示例代碼介紹的非常詳細(xì)。對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2022-10-10
SpringBoot集成Devtools實(shí)現(xiàn)熱更新
DevTools是開發(fā)者工具集,主要用于簡(jiǎn)化開發(fā)過程中的熱部署問題,熱部署是指在開發(fā)過程中,當(dāng)代碼發(fā)生變化時(shí),無需手動(dòng)重啟應(yīng)用,系統(tǒng)能夠自動(dòng)檢測(cè)并重新加載修改后的代碼,本文給大家介紹了SpringBoot集成Devtools實(shí)現(xiàn)熱更新,需要的朋友可以參考下2024-08-08
我們?cè)陂_發(fā)中需要對(duì)用戶敏感數(shù)據(jù)進(jìn)行加解密,比如密碼等信息,這篇文章主要為大家詳細(xì)介紹了java如何使用RSA工具進(jìn)行信息加解密,感興趣的小伙伴可以了解下2023-12-12
Spring Boot 項(xiàng)目做性能監(jiān)控的操作流程
這篇文章主要介紹了Spring Boot 項(xiàng)目如何做性能監(jiān)控,本文通過實(shí)例代碼圖文相結(jié)合給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2020-07-07
SpringBoot定時(shí)監(jiān)聽RocketMQ的NameServer問題及解決方案
這篇文章主要介紹了SpringBoot定時(shí)監(jiān)聽RocketMQ的NameServer問題及解決方案,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友參考下吧2023-12-12
最近在用ssm框架做一個(gè)管理系統(tǒng)，做到登錄驗(yàn)證時(shí)，需要實(shí)現(xiàn)圖片驗(yàn)證碼功能，今天小編給大家分享基于java制作的圖片驗(yàn)證碼功能，感興趣的朋友一起看看吧2019-12-12
基于FLink實(shí)現(xiàn)實(shí)時(shí)安全檢測(cè)的示例代碼
這篇文章主要為大家詳細(xì)介紹了如何基于FLink實(shí)現(xiàn)實(shí)時(shí)安全檢測(cè)的功能，文中的示例代碼講解詳細(xì)，具有一定的借鑒價(jià)值，感興趣的可以了解一下2023-02-02
FastJson時(shí)間格式化問題避坑經(jīng)驗(yàn)分享
這篇文章主要為大家介紹了FastJson時(shí)間格式化問題避坑經(jīng)驗(yàn)分享，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-08-08
這篇文章主要介紹了使用SpringBoot中整合Redis，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-06-06