JSON 解析錯誤排查：Unexpected token、尾逗號、引號和大整數

JSON.parse() 很嚴格。嚴格是資料交換的優點，但也意味著 JavaScript 物件字面量、日誌裡的「類 JSON」、和真正合法 JSON 之間的小差異，都會導致解析失敗。

最常見的 JSON 解析錯誤來自：

JSON 不是 JavaScript 物件字面量

下面是合法 JavaScript，但不是合法 JSON：

{
  name: 'Ada',
  active: true,
}

合法 JSON 必須使用雙引號包住 key 和字串，並且不能有尾逗號：

{
  "name": "Ada",
  "active": true
}

如果瀏覽器主控台、文件或後端日誌裡展示的「JSON」帶單引號或未加引號的 key，在嚴格解析前都應該當作類 JSON 文字。

Unexpected token 表示解析器在某個位置遇到了不該出現的字元。

{"name": "Ada",}

"Ada" 後面的尾逗號非法。

{'name': 'Ada'}

單引號非法。

{name: "Ada"}

物件 key 必須使用雙引號。

{
  "name": "Ada" // user name
}

JSON 裡不能有註解。

API 呼叫出現 JSON parse error 時，先看原始回應，不要先改解析程式碼。

常見意外情況：

前端可以暫時這樣除錯：

const text = await response.text()
console.log(text)
const data = JSON.parse(text)

如果第一個字元是 <，你很可能在解析 HTML。如果開頭是 Warning: 或堆疊資訊，應先修伺服端輸出。

格式化工具能讓合法 JSON 更易讀，但不能在沒有假設的情況下安全格式化非法 JSON。

用 JSON 工具定位：

然後修源資料。不要依賴格式化工具自動「修復」正式環境 payload，除非你清楚它改了什麼。

JSON 字串裡，反斜線是轉義字元。

合法：

{
  "path": "C:\\\\Users\\\\Ada",
  "quote": "She said \\\"hello\\\""
}

非法：

{
  "path": "C:\Users\Ada"
}

如果資料來自某種程式語言的字串字面量，要注意可能有兩層轉義：語言字串一層，JSON 字串一層。

JSON 支援數字，但 JavaScript 會把它解析成 Number。非常大的整數可能遺失精度。

有風險：

{
  "order_id": 12345678901234567890
}

更穩：

{
  "order_id": "12345678901234567890"
}

訂單號、支付流水、資料庫主鍵這類超過 JavaScript 安全整數範圍的 ID，通常應該序列化為字串。

JSON 解析失敗時：