跳至主要內容
FrAIFlow

問題解決指南

JSON 看起來正確,為什麼第一個字元就解析失敗?

明明看得到格式正常的 JSON 物件,卻在第 0 個位置出現錯誤?左大括號不一定是檔案的第一個字元,它前面可能藏著看不見的 U+FEFF。動手修復前,請先保留原始檔。若實際拿到的是 HTML 登入頁、空白回應,或用錯誤編碼解碼的檔案,就需要採取另一種處理方式。

2017 年的一則 Stack Overflow 討論將類似的 Node.js 錯誤追溯到十進位 65279,也就是 U+FEFF。另外,本文保存的本機瀏覽器測試使用人工建立的 U+FEFF 加上 {"ok":true}:原本解析失敗,只移除開頭標記後便能解析。截圖記錄的是這次本機測試,不是發問者的檔案。

先用這個保守的方法修復

請對檔案副本操作,不要直接處理唯一的匯出檔。如果資料來自網路請求,先檢查 HTTP 狀態碼與內容類型。以 <!doctype html> 開頭的登入頁需要修正驗證流程,並不是清理 JSON 就能解決。本機檔案則可用能顯示編碼的編輯器檢查。調查期間不要覆寫原始檔。

將檔案正確解碼為名為 text 的 JavaScript 字串後,可以在匯入程式加入以下小函式。它只接受已知的單一開頭標記,其他內容一律不動。

function parseJsonText(text) {
  if (typeof text !== "string") throw new TypeError("Expected text");
  const hadBOM = text.charCodeAt(0) === 0xFEFF;
  const cleaned = hadBOM ? text.slice(1) : text;
  return { value: JSON.parse(cleaned), removedLeadingBOM: hadBOM };
}
const sample = '\uFEFF{"ok":true,"name":"한글"}';
const result = parseJsonText(sample);
console.log(result.removedLeadingBOM); // true
console.log(result.value.ok);          // true
console.log(result.value.name);        // 한글

確認成功不能只看「錯誤消失了」。還要檢查預期屬性是否存在,以及非英文字元是否仍正常顯示。也請用一般 JSON 測試這個函式:它應能正常解析,且不會回報移除標記。空白輸入或格式錯誤的物件仍應拋出例外。請讓呼叫端看得到錯誤,不要以空物件代替,以免被誤認為有效資料。

如果第一個碼位不是 U+FEFF,就不要沿用這個修復方法。例如,以錯誤編碼解讀的檔案可能包含替代字元,或每隔一個字元就有空字元。請改用匯出端指定的編碼重新開啟,或重新取得 UTF-8 匯出檔。單純刪除字元無法還原已被錯誤解碼的位元組。

分清楚位元組與看不見的字元

隱藏前綴 U+FEFF 加上 {"ok":true},使 JSON.parse 拒絕解析
作者製作的說明圖,並非應用程式畫面截圖。

TextDecoder("utf-8") 通常會略過開頭的 UTF-8 BOM。ignoreBOM 這個選項的行為容易讓人誤解:設為 true 時,反而會把標記保留在解碼後的字串中。本文測試的位元組 EF BB BF 7B 7D 在預設行為下得到 {}。這不代表解碼器會自動偵測檔案編碼。

回頭檢查資料是怎麼產生的

另一則 PowerShell 討論的問題出在解碼流程。Windows PowerShell 的 Out-File 與重新導向可能產生 UTF-16LE;較新版 PowerShell 的行為則不同。刪除非 ASCII 字元可能破壞有效姓名,卻仍無法修正編碼不符。請確認產生檔案的指令與版本,再正確解碼或重新匯出。我們的測試並未重現該使用者的完整工作流程。

RFC 8259 要求在封閉生態系之外交換的 JSON 使用 UTF-8,並禁止產生端在網路傳輸的 JSON 加上 BOM。可以的話,應直接修正匯出端。在匯入邊界,請涵蓋一般 JSON、已確認的開頭標記、格式錯誤 JSON,以及非英文字元等測試。診斷紀錄只需保留必要的開頭資訊,不要寫入私人文件內容。

圖解連結 UTF-8 BOM 的 EF BB BF、U+FEFF 與 JSON 解析錯誤,並顯示僅移除開頭字元後的成功結果
輔助說明圖,並非應用程式畫面截圖。
保存的測試結果:連結 UTF-8 BOM 的 EF BB BF、U+FEFF 與 JSON 解析錯誤,並顯示僅移除開頭字元後的成功結果
已保存的本機測試結果。開啟圖片即可查看原始證據。
資料來源、範例與延伸閱讀