：解析、查詢與避坑指南)
簡介這份資源是一套面向Java初學者與Web開發(fā)入門者的JSON完整示例工程圍繞JSON語法、解析與生成展開幫助讀者理解鍵值對、數(shù)組、嵌套對象等核心結(jié)構(gòu)并掌握在代碼中處理JSON數(shù)據(jù)的常見方式。壓縮包共22個文件約2.88MB以14個jar依賴包為主輔以2個java源碼、2個class編譯文件及classpath、project等工程配置另附1份json筆記整體構(gòu)成可直接導入運行的JsonDemo項目依賴涵蓋json-lib、commons系列等常用庫。目前已有3576人學習下載適合需要對照示例理解JSON序列化與反序列化流程的開發(fā)者。通過源碼與筆記讀者可快速掌握JSON對象構(gòu)建、字符串轉(zhuǎn)換及依賴配置思路為接口數(shù)據(jù)交換與AJAX場景打下基礎。1. 從一份“json完整例子”說起為什么你搜到的 JSON 教程總是跑不通你搜“json完整例子”大概率不是想聽 JSON 是什么——全稱 JavaScript Object Notation一種輕量級數(shù)據(jù)交換格式這你早知道了。你真正卡住的是拿到一份 JSON 文件不知道用什么打開、怎么解析、字段怎么取、嵌套數(shù)組怎么遍歷、格式錯了怎么排查。更具體一點你可能正在做接口聯(lián)調(diào)、配置視頻源、處理大模型返回的 JSON 字段或者被一個 merge conflict 卡了半天。這份“json完整例子”資源的價值就在這它不是概念科普而是一組可直接運行的完整示例覆蓋對象、數(shù)組、嵌套結(jié)構(gòu)、類型邊界和常見解析場景。適合三類人剛接觸接口開發(fā)的新手需要一份能照著敲的模板做數(shù)據(jù)處理的工程師想快速驗證解析邏輯以及被 JSON 格式問題反復折騰、想搞清邊界的人。下面我按“先看懂結(jié)構(gòu)、再動手解析、最后避坑”的順序拆開講。2. JSON 結(jié)構(gòu)拆解對象、數(shù)組與嵌套到底怎么組織2.1 六種值類型與三種結(jié)構(gòu)形態(tài)JSON 的值類型只有六種字符串、數(shù)字、布爾、null、對象、數(shù)組。前四種是標量后兩種是容器。所有復雜的 JSON 都是這六種類型嵌套組合出來的。理解這一點后面解析時遇到任何結(jié)構(gòu)都不會慌。對象用花括號{}包裹內(nèi)部是鍵值對鍵必須是雙引號字符串值可以是任意類型。數(shù)組用方括號[]包裹元素可以是任意類型且允許混合。嵌套就是容器里再放容器。常見做法是對象表示一條記錄數(shù)組表示一批記錄嵌套對象表示關聯(lián)信息。{ id: 1001, name: 示例資源, active: true, tags: [json, tutorial, example], meta: { author: engineer, version: 2, published: null }, items: [ { sku: A1, price: 19.9, stock: 3 }, { sku: B2, price: 5.0, stock: 0 } ] }這段結(jié)構(gòu)里tags是字符串數(shù)組meta是嵌套對象items是對象數(shù)組。解析時最容易出錯的地方是把items當成對象去取鍵或者遍歷meta時忘了它是對象不是數(shù)組。判斷方法很簡單——看外層是{}還是[]{}用鍵訪問[]用索引或循環(huán)。2.2 用 Python 完整解析一份嵌套 JSONPython 標準庫json就夠用不需要額外裝包。下面這段代碼把上面的結(jié)構(gòu)解析出來并演示三種取值方式。import json raw { id: 1001, name: 示例資源, tags: [json, tutorial], meta: {author: engineer, version: 2}, items: [ {sku: A1, price: 19.9, stock: 3}, {sku: B2, price: 5.0, stock: 0} ] } data json.loads(raw) # 字符串轉(zhuǎn)字典 print(data[name]) # 直接取標量 print(data[meta][author]) # 嵌套對象逐層取 for item in data[items]: # 數(shù)組用循環(huán) if item[stock] 0: print(item[sku], item[price])json.loads()把字符串轉(zhuǎn)成 Python 字典如果是從文件讀就用json.load(open(...))。取值時data[meta][author]是逐層下鉆中間任何一層鍵不存在都會拋KeyError。遍歷數(shù)組用for不要用data[items][0]硬編碼索引除非你確定只有一條。item[stock] 0這種判斷在過濾有效數(shù)據(jù)時很常用比如篩掉無庫存的記錄。參數(shù)上唯一需要注意的是json.loads的parse_float和parse_int默認轉(zhuǎn)成 Python 的 float 和 int。如果價格字段精度要求高可以傳parse_floatDecimal避免浮點誤差。這個細節(jié)在處理金額類 JSON 時是血淚經(jīng)驗。2.3 用 JavaScript 解析并處理數(shù)組過濾前端或 Node 環(huán)境里JSON.parse()是標配。下面演示解析后過濾出有庫存的商品并轉(zhuǎn)成新數(shù)組。const raw {items:[{sku:A1,price:19.9,stock:3},{sku:B2,price:5.0,stock:0}]}; const data JSON.parse(raw); // 字符串轉(zhuǎn)對象 const available data.items.filter( // 過濾有庫存的 item item.stock 0 ); available.forEach(item { console.log(${item.sku} 價格 ${item.price}); });JSON.parse()遇到格式錯誤會直接拋SyntaxError不會返回部分結(jié)果。filter返回新數(shù)組不改變原數(shù)據(jù)。forEach只做遍歷需要返回新數(shù)組時用map。這里容易翻車的是模板字符串里再嵌 JSON 字符串反引號和雙引號混用會導致解析失敗建議 JSON 部分單獨用單引號或轉(zhuǎn)義。3. 從文件到接口JSON 讀取、查詢與轉(zhuǎn)換的完整鏈路3.1 讀取本地 JSON 文件的三種方式不同場景讀文件的方式不一樣。Python 讀本地文件最直接import json with open(data.json, r, encodingutf-8) as f: data json.load(f) # 直接從文件對象加載 print(type(data)) # dict 或 listencodingutf-8必須顯式寫否則在部分系統(tǒng)上中文會亂碼。如果文件很大json.load會一次性讀進內(nèi)存幾百 MB 以上建議用ijson流式解析。判斷文件是對象還是數(shù)組看開頭第一個非空白字符是{還是[。Node 環(huán)境讀文件const fs require(fs); const data JSON.parse( fs.readFileSync(data.json, utf-8) ); console.log(Array.isArray(data));readFileSync是同步讀適合啟動時加載配置。接口服務里建議用fs.promises.readFile異步讀避免阻塞。Array.isArray用來判斷頂層是數(shù)組還是對象決定后續(xù)用循環(huán)還是取鍵。3.2 JSON 查詢按字段篩選與嵌套取值“json查詢函數(shù)”是高頻搜索詞很多人想要的是類似 SQL 的查詢能力。Python 里沒有內(nèi)置 JSON 查詢語法但可以用列表推導和filter組合實現(xiàn)。import json data json.loads(open(data.json, encodingutf-8).read()) # 查詢 stock 大于 0 且 price 小于 20 的記錄 result [ item for item in data[items] if item[stock] 0 and item[price] 20 ] print(result) # 提取所有 sku 組成新列表 skus [item[sku] for item in data[items]] print(skus)列表推導里if可以寫多個條件用and連接。提取字段用[item[sku] for item in ...]這是最常用的投影操作。如果嵌套層級深比如data[meta][author]建議先賦值給中間變量避免重復下鉆和潛在KeyError。需要更復雜的查詢時常見做法是用jmespath或jsonpath-ng語法類似items[?stock \0].sku。但引入第三方庫前先確認標準庫能不能滿足多數(shù)篩選場景列表推導就夠了。3.3 JSON 轉(zhuǎn)其他格式CSV、TXT 與掩碼處理“json轉(zhuǎn)txt掩碼”這類需求通常出現(xiàn)在數(shù)據(jù)導出場景。把 JSON 數(shù)組轉(zhuǎn) CSVimport json, csv data json.loads(open(data.json, encodingutf-8).read()) with open(out.csv, w, newline, encodingutf-8) as f: writer csv.DictWriter(f, fieldnames[sku, price, stock]) writer.writeheader() for item in data[items]: writer.writerow(item)DictWriter要求每行是字典fieldnames決定列順序。newline防止 Windows 下多空行。如果 JSON 字段比 CSV 列多只寫fieldnames里列出的鍵多余的自動忽略。轉(zhuǎn) TXT 掩碼時通常是把敏感字段替換成固定字符masked [ {**item, sku: item[sku][:2] ***} for item in data[items] ]{**item, sku: ...}是淺拷貝并覆蓋字段不修改原數(shù)據(jù)。掩碼規(guī)則按業(yè)務定常見是保留前兩位、其余替換。4. 避坑與排查JSON 解析中最容易翻車的五個場景4.1 現(xiàn)象解析報JSONDecodeError但肉眼看著格式?jīng)]錯原因通常有三類末尾多了逗號、用了單引號、鍵沒加雙引號。JSON 標準不允許尾逗號不允許單引號字符串鍵必須雙引號。肉眼掃一遍很難發(fā)現(xiàn)尤其是長文件。解決用在線校驗工具或命令行python -m json.tool data.json它會指出具體行號。VS Code 里裝 JSON 插件也能實時標紅。養(yǎng)成保存前格式化一次的習慣能省很多排查時間。4.2 現(xiàn)象中文顯示成\u4e2d\u6587轉(zhuǎn)義序列原因json.dumps默認ensure_asciiTrue會把非 ASCII 字符轉(zhuǎn)義。讀取時其實不影響但直接看文件很痛苦。解決導出時加ensure_asciiFalse。json.dumps(data, ensure_asciiFalse, indent2)indent2讓輸出帶縮進方便人看。讀取時不需要額外參數(shù)json.load會自動還原轉(zhuǎn)義。4.3 現(xiàn)象大整數(shù)或高精度小數(shù)解析后精度丟失原因JavaScript 的JSON.parse把所有數(shù)字轉(zhuǎn)成雙精度浮點超過 2^53 的整數(shù)會丟精度。Python 默認 int 不丟但 float 有浮點誤差。解決金額類字段在 JSON 里用字符串存解析后按需轉(zhuǎn)Decimal。大整數(shù) ID 同樣建議用字符串。這是接口設計階段就要定的規(guī)則事后補救很麻煩。4.4 現(xiàn)象merge conflict 時 JSON 文件沖突無法自動合并原因JSON 是純文本Git 按行合并兩個分支同時改同一段結(jié)構(gòu)就會沖突。如果格式化風格不一致一個縮進 2 空格一個 4 空格整個文件都會沖突。解決團隊統(tǒng)一格式化工具比如 Prettier 配.prettierrc提交前跑一遍。沖突時不要手動刪括號用git checkout --theirs或--ours先選一邊再手動補差異。結(jié)構(gòu)復雜的 JSON 建議拆成多個小文件降低沖突概率。4.5 現(xiàn)象接口返回的 JSON 里字段有時是對象有時是數(shù)組原因后端設計不一致或者空結(jié)果時返回{}而非[]。前端按數(shù)組遍歷就會報錯。解決解析后先判斷類型再處理。const items Array.isArray(data.items) ? data.items : [];這行兜底能避免大部分運行時錯誤。更根本的辦法是推動接口規(guī)范統(tǒng)一空數(shù)組返回[]空對象返回{}不要混用。5. 進階技巧用 JSON Schema 校驗結(jié)構(gòu)把錯誤擋在解析之前前面講的都是解析后處理但更高效的做法是解析前先校驗。JSON Schema 就是干這個的——它用一份 JSON 描述另一份 JSON 應該長什么樣字段類型、必填項、取值范圍都能約束。常見做法是在接口入口或配置文件加載時先跑一遍校驗不合格直接拒絕避免臟數(shù)據(jù)流到下游。Python 里用jsonschema庫import json from jsonschema import validate, ValidationError schema { type: object, required: [id, name, items], properties: { id: {type: integer}, name: {type: string}, items: { type: array, items: { type: object, required: [sku, price], properties: { sku: {type: string}, price: {type: number, minimum: 0} } } } } } data json.loads(open(data.json, encodingutf-8).read()) try: validate(instancedata, schemaschema) print(校驗通過) except ValidationError as e: print(校驗失敗:, e.message)required列出必填字段缺一個就報錯。type約束類型minimum約束數(shù)值下限。items嵌套 schema 可以逐層校驗數(shù)組元素。ValidationError的message會指出具體哪個字段不滿足排查很快。參數(shù)上validate默認遇到第一個錯誤就停想看全部錯誤用iter_errors。schema 本身也可以存成獨立 JSON 文件用json.load讀進來方便版本管理。校驗項關鍵字作用必填required字段缺失即報錯類型type限定 string/number/object 等數(shù)值范圍minimum / maximum限定數(shù)字上下限字符串長度minLength / maxLength限定字符數(shù)數(shù)組元素items對每個元素套用子 schema這張表覆蓋了日常八成校驗需求。更復雜的還有oneOf、anyOf、pattern按需查文檔即可。我現(xiàn)在的習慣是任何外部來源的 JSON不管是接口返回還是配置文件進業(yè)務邏輯前先過一遍 schema。有一次線上事故就是配置文件里port寫成了字符串8080解析沒報錯但后續(xù)拼接 URL 時出了玄學問題查了兩小時。從那以后我每次加載 JSON 配置都強制走一遍校驗寧可啟動時多花幾毫秒也不讓臟數(shù)據(jù)跑到運行時。希望幫到你。本文還有配套的精品資源點擊獲取 JSON完整例子實戰(zhàn)：解析、查詢與避坑指南
簡介這份資源是一套面向Java初學者與Web開發(fā)入門者的JSON完整示例工程圍繞JSON語法、解析與生成展開幫助讀者理解鍵值對、數(shù)組、嵌套對象等核心結(jié)構(gòu)并掌握在代碼中處理JSON數(shù)據(jù)的常見方式。壓縮包共22個文件約2.88MB以14個jar依賴包為主輔以2個java源碼、2個class編譯文件及classpath、project等工程配置另附1份json筆記整體構(gòu)成可直接導入運行的JsonDemo項目依賴涵蓋json-lib、commons系列等常用庫。目前已有3576人學習下載適合需要對照示例理解JSON序列化與反序列化流程的開發(fā)者。通過源碼與筆記讀者可快速掌握JSON對象構(gòu)建、字符串轉(zhuǎn)換及依賴配置思路為接口數(shù)據(jù)交換與AJAX場景打下基礎。1. 從一份“json完整例子”說起為什么你搜到的 JSON 教程總是跑不通你搜“json完整例子”大概率不是想聽 JSON 是什么——全稱 JavaScript Object Notation一種輕量級數(shù)據(jù)交換格式這你早知道了。你真正卡住的是拿到一份 JSON 文件不知道用什么打開、怎么解析、字段怎么取、嵌套數(shù)組怎么遍歷、格式錯了怎么排查。更具體一點你可能正在做接口聯(lián)調(diào)、配置視頻源、處理大模型返回的 JSON 字段或者被一個 merge conflict 卡了半天。這份“json完整例子”資源的價值就在這它不是概念科普而是一組可直接運行的完整示例覆蓋對象、數(shù)組、嵌套結(jié)構(gòu)、類型邊界和常見解析場景。適合三類人剛接觸接口開發(fā)的新手需要一份能照著敲的模板做數(shù)據(jù)處理的工程師想快速驗證解析邏輯以及被 JSON 格式問題反復折騰、想搞清邊界的人。下面我按“先看懂結(jié)構(gòu)、再動手解析、最后避坑”的順序拆開講。2. JSON 結(jié)構(gòu)拆解對象、數(shù)組與嵌套到底怎么組織2.1 六種值類型與三種結(jié)構(gòu)形態(tài)JSON 的值類型只有六種字符串、數(shù)字、布爾、null、對象、數(shù)組。前四種是標量后兩種是容器。所有復雜的 JSON 都是這六種類型嵌套組合出來的。理解這一點后面解析時遇到任何結(jié)構(gòu)都不會慌。對象用花括號{}包裹內(nèi)部是鍵值對鍵必須是雙引號字符串值可以是任意類型。數(shù)組用方括號[]包裹元素可以是任意類型且允許混合。嵌套就是容器里再放容器。常見做法是對象表示一條記錄數(shù)組表示一批記錄嵌套對象表示關聯(lián)信息。{ id: 1001, name: 示例資源, active: true, tags: [json, tutorial, example], meta: { author: engineer, version: 2, published: null }, items: [ { sku: A1, price: 19.9, stock: 3 }, { sku: B2, price: 5.0, stock: 0 } ] }這段結(jié)構(gòu)里tags是字符串數(shù)組meta是嵌套對象items是對象數(shù)組。解析時最容易出錯的地方是把items當成對象去取鍵或者遍歷meta時忘了它是對象不是數(shù)組。判斷方法很簡單——看外層是{}還是[]{}用鍵訪問[]用索引或循環(huán)。2.2 用 Python 完整解析一份嵌套 JSONPython 標準庫json就夠用不需要額外裝包。下面這段代碼把上面的結(jié)構(gòu)解析出來并演示三種取值方式。import json raw { id: 1001, name: 示例資源, tags: [json, tutorial], meta: {author: engineer, version: 2}, items: [ {sku: A1, price: 19.9, stock: 3}, {sku: B2, price: 5.0, stock: 0} ] } data json.loads(raw) # 字符串轉(zhuǎn)字典 print(data[name]) # 直接取標量 print(data[meta][author]) # 嵌套對象逐層取 for item in data[items]: # 數(shù)組用循環(huán) if item[stock] 0: print(item[sku], item[price])json.loads()把字符串轉(zhuǎn)成 Python 字典如果是從文件讀就用json.load(open(...))。取值時data[meta][author]是逐層下鉆中間任何一層鍵不存在都會拋KeyError。遍歷數(shù)組用for不要用data[items][0]硬編碼索引除非你確定只有一條。item[stock] 0這種判斷在過濾有效數(shù)據(jù)時很常用比如篩掉無庫存的記錄。參數(shù)上唯一需要注意的是json.loads的parse_float和parse_int默認轉(zhuǎn)成 Python 的 float 和 int。如果價格字段精度要求高可以傳parse_floatDecimal避免浮點誤差。這個細節(jié)在處理金額類 JSON 時是血淚經(jīng)驗。2.3 用 JavaScript 解析并處理數(shù)組過濾前端或 Node 環(huán)境里JSON.parse()是標配。下面演示解析后過濾出有庫存的商品并轉(zhuǎn)成新數(shù)組。const raw {items:[{sku:A1,price:19.9,stock:3},{sku:B2,price:5.0,stock:0}]}; const data JSON.parse(raw); // 字符串轉(zhuǎn)對象 const available data.items.filter( // 過濾有庫存的 item item.stock 0 ); available.forEach(item { console.log(${item.sku} 價格 ${item.price}); });JSON.parse()遇到格式錯誤會直接拋SyntaxError不會返回部分結(jié)果。filter返回新數(shù)組不改變原數(shù)據(jù)。forEach只做遍歷需要返回新數(shù)組時用map。這里容易翻車的是模板字符串里再嵌 JSON 字符串反引號和雙引號混用會導致解析失敗建議 JSON 部分單獨用單引號或轉(zhuǎn)義。3. 從文件到接口JSON 讀取、查詢與轉(zhuǎn)換的完整鏈路3.1 讀取本地 JSON 文件的三種方式不同場景讀文件的方式不一樣。Python 讀本地文件最直接import json with open(data.json, r, encodingutf-8) as f: data json.load(f) # 直接從文件對象加載 print(type(data)) # dict 或 listencodingutf-8必須顯式寫否則在部分系統(tǒng)上中文會亂碼。如果文件很大json.load會一次性讀進內(nèi)存幾百 MB 以上建議用ijson流式解析。判斷文件是對象還是數(shù)組看開頭第一個非空白字符是{還是[。Node 環(huán)境讀文件const fs require(fs); const data JSON.parse( fs.readFileSync(data.json, utf-8) ); console.log(Array.isArray(data));readFileSync是同步讀適合啟動時加載配置。接口服務里建議用fs.promises.readFile異步讀避免阻塞。Array.isArray用來判斷頂層是數(shù)組還是對象決定后續(xù)用循環(huán)還是取鍵。3.2 JSON 查詢按字段篩選與嵌套取值“json查詢函數(shù)”是高頻搜索詞很多人想要的是類似 SQL 的查詢能力。Python 里沒有內(nèi)置 JSON 查詢語法但可以用列表推導和filter組合實現(xiàn)。import json data json.loads(open(data.json, encodingutf-8).read()) # 查詢 stock 大于 0 且 price 小于 20 的記錄 result [ item for item in data[items] if item[stock] 0 and item[price] 20 ] print(result) # 提取所有 sku 組成新列表 skus [item[sku] for item in data[items]] print(skus)列表推導里if可以寫多個條件用and連接。提取字段用[item[sku] for item in ...]這是最常用的投影操作。如果嵌套層級深比如data[meta][author]建議先賦值給中間變量避免重復下鉆和潛在KeyError。需要更復雜的查詢時常見做法是用jmespath或jsonpath-ng語法類似items[?stock \0].sku。但引入第三方庫前先確認標準庫能不能滿足多數(shù)篩選場景列表推導就夠了。3.3 JSON 轉(zhuǎn)其他格式CSV、TXT 與掩碼處理“json轉(zhuǎn)txt掩碼”這類需求通常出現(xiàn)在數(shù)據(jù)導出場景。把 JSON 數(shù)組轉(zhuǎn) CSVimport json, csv data json.loads(open(data.json, encodingutf-8).read()) with open(out.csv, w, newline, encodingutf-8) as f: writer csv.DictWriter(f, fieldnames[sku, price, stock]) writer.writeheader() for item in data[items]: writer.writerow(item)DictWriter要求每行是字典fieldnames決定列順序。newline防止 Windows 下多空行。如果 JSON 字段比 CSV 列多只寫fieldnames里列出的鍵多余的自動忽略。轉(zhuǎn) TXT 掩碼時通常是把敏感字段替換成固定字符masked [ {**item, sku: item[sku][:2] ***} for item in data[items] ]{**item, sku: ...}是淺拷貝并覆蓋字段不修改原數(shù)據(jù)。掩碼規(guī)則按業(yè)務定常見是保留前兩位、其余替換。4. 避坑與排查JSON 解析中最容易翻車的五個場景4.1 現(xiàn)象解析報JSONDecodeError但肉眼看著格式?jīng)]錯原因通常有三類末尾多了逗號、用了單引號、鍵沒加雙引號。JSON 標準不允許尾逗號不允許單引號字符串鍵必須雙引號。肉眼掃一遍很難發(fā)現(xiàn)尤其是長文件。解決用在線校驗工具或命令行python -m json.tool data.json它會指出具體行號。VS Code 里裝 JSON 插件也能實時標紅。養(yǎng)成保存前格式化一次的習慣能省很多排查時間。4.2 現(xiàn)象中文顯示成\u4e2d\u6587轉(zhuǎn)義序列原因json.dumps默認ensure_asciiTrue會把非 ASCII 字符轉(zhuǎn)義。讀取時其實不影響但直接看文件很痛苦。解決導出時加ensure_asciiFalse。json.dumps(data, ensure_asciiFalse, indent2)indent2讓輸出帶縮進方便人看。讀取時不需要額外參數(shù)json.load會自動還原轉(zhuǎn)義。4.3 現(xiàn)象大整數(shù)或高精度小數(shù)解析后精度丟失原因JavaScript 的JSON.parse把所有數(shù)字轉(zhuǎn)成雙精度浮點超過 2^53 的整數(shù)會丟精度。Python 默認 int 不丟但 float 有浮點誤差。解決金額類字段在 JSON 里用字符串存解析后按需轉(zhuǎn)Decimal。大整數(shù) ID 同樣建議用字符串。這是接口設計階段就要定的規(guī)則事后補救很麻煩。4.4 現(xiàn)象merge conflict 時 JSON 文件沖突無法自動合并原因JSON 是純文本Git 按行合并兩個分支同時改同一段結(jié)構(gòu)就會沖突。如果格式化風格不一致一個縮進 2 空格一個 4 空格整個文件都會沖突。解決團隊統(tǒng)一格式化工具比如 Prettier 配.prettierrc提交前跑一遍。沖突時不要手動刪括號用git checkout --theirs或--ours先選一邊再手動補差異。結(jié)構(gòu)復雜的 JSON 建議拆成多個小文件降低沖突概率。4.5 現(xiàn)象接口返回的 JSON 里字段有時是對象有時是數(shù)組原因后端設計不一致或者空結(jié)果時返回{}而非[]。前端按數(shù)組遍歷就會報錯。解決解析后先判斷類型再處理。const items Array.isArray(data.items) ? data.items : [];這行兜底能避免大部分運行時錯誤。更根本的辦法是推動接口規(guī)范統(tǒng)一空數(shù)組返回[]空對象返回{}不要混用。5. 進階技巧用 JSON Schema 校驗結(jié)構(gòu)把錯誤擋在解析之前前面講的都是解析后處理但更高效的做法是解析前先校驗。JSON Schema 就是干這個的——它用一份 JSON 描述另一份 JSON 應該長什么樣字段類型、必填項、取值范圍都能約束。常見做法是在接口入口或配置文件加載時先跑一遍校驗不合格直接拒絕避免臟數(shù)據(jù)流到下游。Python 里用jsonschema庫import json from jsonschema import validate, ValidationError schema { type: object, required: [id, name, items], properties: { id: {type: integer}, name: {type: string}, items: { type: array, items: { type: object, required: [sku, price], properties: { sku: {type: string}, price: {type: number, minimum: 0} } } } } } data json.loads(open(data.json, encodingutf-8).read()) try: validate(instancedata, schemaschema) print(校驗通過) except ValidationError as e: print(校驗失敗:, e.message)required列出必填字段缺一個就報錯。type約束類型minimum約束數(shù)值下限。items嵌套 schema 可以逐層校驗數(shù)組元素。ValidationError的message會指出具體哪個字段不滿足排查很快。參數(shù)上validate默認遇到第一個錯誤就停想看全部錯誤用iter_errors。schema 本身也可以存成獨立 JSON 文件用json.load讀進來方便版本管理。校驗項關鍵字作用必填required字段缺失即報錯類型type限定 string/number/object 等數(shù)值范圍minimum / maximum限定數(shù)字上下限字符串長度minLength / maxLength限定字符數(shù)數(shù)組元素items對每個元素套用子 schema這張表覆蓋了日常八成校驗需求。更復雜的還有oneOf、anyOf、pattern按需查文檔即可。我現(xiàn)在的習慣是任何外部來源的 JSON不管是接口返回還是配置文件進業(yè)務邏輯前先過一遍 schema。有一次線上事故就是配置文件里port寫成了字符串8080解析沒報錯但后續(xù)拼接 URL 時出了玄學問題查了兩小時。從那以后我每次加載 JSON 配置都強制走一遍校驗寧可啟動時多花幾毫秒也不讓臟數(shù)據(jù)跑到運行時。希望幫到你。本文還有配套的精品資源點擊獲取