如何驗證 JSON:常見錯誤與修復方法
您的 API 回傳了 400 錯誤。日誌顯示「Invalid JSON」。您盯著 payload 看,一切似乎正常——直到您發現藏在第 47 行的單引號。JSON 驗證錯誤之所以令人沮喪,正是因為它們往往是破壞一切的微小錯誤。
最常見的 JSON 語法錯誤
1. 尾隨逗號
JSON 中最常見的錯誤。JavaScript 允許尾隨逗號,所以開發者會將這個習慣帶入 JSON——但在 JSON 中這是無效的。
{
"name": "Alex",
"age": 30
}
務必移除最後一個值之後的逗號。
2. 單引號取代雙引號
JSON 要求使用雙引號。以下在 JavaScript 中有效但在 JSON 中無效:{'name': 'Alex'}。請將所有單引號替換為雙引號。
3. 未加引號的鍵
JSON 中的每個鍵都必須是帶引號的字串。{name: "Alex"} 應改為 {"name": "Alex"}。
4. 元素間缺少逗號
手動編輯 JSON 時容易遺漏——忘記在鍵值對之間加上逗號。
5. 括號不匹配
用 { 開始但用 ] 結束,或巢狀結構不正確。使用能標示配對括號的 JSON 驗證器來檢查。
如何有效驗證 JSON
快速手動驗證
將您的 JSON 貼入我們的 JSON 驗證器。它會標示出錯誤的確切行號和字元位置。所有處理都在您的瀏覽器中完成——您的資料永遠不會離開您的電腦。
程式化驗證
在應用程式中,應在每個邊界驗證 JSON。在 JavaScript 中,用 try-catch 包裝 JSON.parse()。在 Python 中,使用搭配例外處理的 json.loads()。
Schema 驗證
語法驗證告訴您 JSON 格式是否正確。Schema 驗證告訴您它是否具有正確的結構。使用我們的 JSON Schema 驗證器來定義預期的資料結構。
逐步除錯 JSON 錯誤
- 先格式化 — 貼入 JSON 格式化工具以獲得正確的縮排
- 檢查錯誤位置 — 大多數解析器會報告行號和欄位
- 檢查常見問題 — 尾隨逗號、單引號、未加引號的鍵
- 逐步驗證 — 對於大型 JSON,分段驗證
- 比較版本 — 使用 JSON Diff 與正常運作的版本進行比較
設定自動化驗證
在編輯器中
啟用 JSON 語法高亮、Linter 和設定檔的 Schema 驗證。
在 CI 流程中
將 JSON 驗證加入建置流程,在合併前捕捉錯誤。
在 API 中
永遠不要信任傳入的 JSON。在 API 邊界同時驗證語法和 Schema。回傳有用的錯誤訊息。
常見問題
JSON 驗證和 JSON Schema 驗證有什麼區別?
JSON 驗證檢查語法(正確的引號、括號、逗號)。JSON Schema 驗證檢查結構——正確的欄位、正確的型別、正確的約束條件。
為什麼我的 JSON 在 JavaScript 中可以運作,但在其他解析器中失敗?
JavaScript 比 JSON 規範更寬鬆。它允許尾隨逗號、單引號和註解。嚴格的解析器會拒絕所有這些。
基本 JSON 格式化規則
使用一致的縮排
選擇 2 個空格或 4 個空格,並在整個專案中保持一致。Tab 也可以,但空格在 JSON 工具中有更廣泛的支援。
{
"user": {
"name": "Alex Chen",
"email": "[email protected]",
"roles": ["admin", "editor"]
}
}
始終使用雙引號
JSON 要求鍵和字串值都使用雙引號。單引號在任何嚴格的 JSON 解析器中都會導致解析錯誤。
保持鍵名一致
選擇一種命名慣例並統一套用。camelCase 在 JavaScript 生態系統中最為常見,而 snake_case 在 Python 的 API 中較為流行。
處理大型 JSON 檔案
大型 JSON 檔案需要特別注意:
- 使用專用的 JSON 編輯器 — 我們的 JSON 編輯器 支援大型檔案的語法高亮
- 比較前先格式化 — 使用 JSON 差異比對 工具來找出實際變更
- 用 JSONPath 擷取資料 — JSONPath 查詢 比手動搜尋更快
相關資源
- JSON Schema 驗證指南 — 強制執行資料契約
- JSON 驗證器工具 — 即時驗證 JSON 語法
- JSON 格式化工具 — 美化並修正 JSON 格式
🛠️ 立即試用: JSON Validator — 100%免費,所有處理在瀏覽器中完成。無需上傳資料。