「Unexpected token '<' ... is not valid JSON」の原因と直し方 — エラー文字列から逆引きする

「Unexpected token '&lt;' ... is not valid JSON」の原因と直し方 — エラー文字列から逆引きする

先に結論:エラー文字列の逆引き表

「先に結論:エラー文字列の逆引き表」の内容を図にまとめたもの

JSON.parse のエラーは、メッセージの文字列を読めば原因がほぼ決まります。 デバッガを起動する前に、まず表を引いてください。

下の表は、Node 24.14.1 と Chrome 152 で実際にパースさせて、出力された文字列をそのまま並べたものです。 どちらもV8なので、出るメッセージは完全に同じでした。

表1:エラー文字列から原因を逆引きする(V8=Chrome / Edge / Node)
エラー文字列渡された中身よくある原因
Unexpected token '<', "<!DOCTYPE "... is not valid JSONHTMLページ404・500・ログイン画面・プロキシのエラーページ(詳しく)
Unexpected token '<', "<html>
<h"... is not valid JSON
DOCTYPEなしのHTMLNginx/Apacheが直接返したエラーページ
Unexpected token '<', "<br />
<b>"... is not valid JSON
PHPの警告+JSONnotice/warningがJSONの前に出力された
Unexpected token 'P', "PHP Fatal "... is not valid JSONPHPの致命的エラー例外が握り潰されず画面に出ている
Unexpected end of JSON input空文字、空白だけ、途中で切れた文字列204 No Content・空ボディ・通信の中断(詳しく)
"undefined" is not valid JSON文字列 undefined、または値の undefined変数が未定義のまま埋め込まれた
"[object Object]" is not valid JSONオブジェクトすでにパース済みのものを再度parseした(詳しく)
Unexpected token 'o', "[object Blob]"... is not valid JSONBlob・Response等を文字列化したものawait res.text() を忘れた
Expected double-quoted property name in JSON at position N末尾カンマ付きのオブジェクト手書きJSON・設定ファイル(詳しく)
Expected property name or '}' in JSON at position 1シングルクォート、またはクォートなしのキーJavaScriptのオブジェクトリテラルと混同
Unexpected token 'N', "{"a":NaN}" is not valid JSONNaN / Infinityサーバー側のシリアライズ
Unexpected token '', ...(見えない文字)BOM付きの文字列ファイルがUTF-8 BOM付きで保存されている
Unexpected non-whitespace character after JSON at position N正しいJSONの後ろにゴミ二重出力・デバッグ用の print が残っている

一番多いのは表の1行目です。「JSONを頼んだのにHTMLが返ってきている」という、 JSONの文法とは何の関係もない話が、ほとんどを占めます。

エラーメッセージの読み方

「エラーメッセージの読み方」の内容を図にまとめたもの

メッセージの形式は途中で変わった

このエラーを検索して、出てきた解説と手元のメッセージが噛み合わないことがあります。理由は単純で、 V8がメッセージの形式を変えたからです。

表2:古い形式と新しい形式
メッセージ分かること
古い形式Unexpected token < in JSON at position 0位置だけ。中身は分からない
新しい形式Unexpected token '<', "<!DOCTYPE "... is not valid JSON中身の先頭が見える

MDNの英語版リファレンス(JSON.parse() のページ)は、 2026年10月25日時点でも古い形式のサンプルを載せたままです。 Unexpected token ] in JSON at position 13 という書き方が残っています。 一方、手元の Node 24.14.1 と Chrome 152 はどちらも新しい形式を出しました。

つまり公式リファレンスですら追いついていないので、 個人ブログの解説が古い形式なのは当然です。 自分の手元に出ている文字列を正とし、表1で引いてください。

引用符の中身が、返ってきた本物

新しい形式のいいところは、引用符の中にレスポンスの実物が入っていることです。 ここが診断の材料になります。

ただし全部は見えません。切り詰めのルールがあります。 これも実測で境界を特定しました。

表3:引用部分の切り詰めルール(実測)
レスポンスの長さ表示例
20文字以下全文がそのまま出る"<aaaaaaaaaaaaaaaaaaa" is not valid JSON
21文字以上先頭10文字+..."<aaaaaaaaa"... is not valid JSON

末尾に ... が付いていたら、レスポンスは21文字以上あって、先頭10文字しか見えていません。 実務で出るHTMLはどれも長いので、ほぼ必ず ... が付きます。 だからエラーメッセージだけで原因を決め切ることはできません。中身を見にいく必要があります。

もうひとつ、V8には例外的な挙動があります。

表4:[object ...] 系のメッセージ(実測)
渡した文字列出るメッセージ
[object Object]"[object Object]" is not valid JSON(専用の形式)
[object Blob]Unexpected token 'o', "[object Blob]" is not valid JSON
[object Array]Unexpected token 'o', "[object Array]" is not valid JSON
[object Promise]Unexpected token 'o', "[object Promise]" is not valid JSON
[object Response]Unexpected token 'o', "[object Response]" is not valid JSON

[object Object] だけ、V8が特別扱いして専用のメッセージを出します。 他の [object なんとか] は普通の形式です。

ちなみに 'o' が「予期しないトークン」として報告されるのは、 [ はJSONの配列の開始として正しく、その次の o で初めて破綻するからです。 エラーの文字が [ ではなく o なのは、そういう理由です。

エンジンごとに文字列が違う

同じ原因でも、ブラウザによってメッセージが全く違います。検索するときはここでハマります。

表5:JSエンジン別のメッセージ形式
エンジン使われている場所形式出典
V8Chrome / Edge / Node.jsUnexpected token '<', "..."... is not valid JSON手元で実測(Node 24.14.1 / Chrome 152)
SpiderMonkeyFirefoxJSON.parse: unexpected character at line 1 column 1 of the JSON dataMDNのエラーリファレンス
JavaScriptCore系Safari などJSON Parse error: Unexpected identifier "..."公開されている不具合報告(未実測)

SpiderMonkeyは at line N column M of the JSON data という形で行と列を出します。 行数の多いJSONを手で直すときはFirefoxで開くほうが速いことがあります。

JavaScriptCore系の文字列は手元で実測していません。 公開されている不具合報告で繰り返し同じ形式が出ているため載せましたが、 Safariで出た文字列を正としてください。

一番多い原因:JSONを頼んだのにHTMLが返っている

「一番多い原因:JSONを頼んだのにHTMLが返っている」の内容を図にまとめたもの

なぜHTMLが返るのか

fetch や axios でAPIを叩いたとき、サーバーは常にJSONを返すとは限りません。 何か想定外のことが起きると、多くの環境はHTMLのエラーページを返します。 そのHTMLを JSON.parse に渡すと、1文字目の < で落ちます。

表6:HTMLが返ってくる典型パターン
状況返ってくるもの気づき方
URLが間違っている(404)フレームワークやWebサーバーの404ページステータスコードが404
サーバー側で例外(500)デバッグ画面やエラーページステータスコードが500
セッション切れログイン画面のHTMLステータスは200。リダイレクト後のページ
プロキシ・WAFにブロックされた「Access denied」等のHTMLステータスは403や503
リバースプロキシが落ちているNginxの502ページステータスは502
開発サーバーのパスが通っていないフロントのindex.htmlがそのまま返るステータスは200。SPAのフォールバック
APIのパスがフロントに食われている同上プロキシ設定の漏れ

注意すべきは「ステータスは200」の行です。 セッション切れでログイン画面にリダイレクトされた場合も、 SPAのフォールバックで index.html が返る場合も、HTTPとしては成功しています。 だから res.ok を見ているだけでは防げません。

エラーメッセージでは区別できない

実際に、実務で出る代表的なHTMLをパースさせてみました。結果はこうです。

表7:返ってきたHTMLの種類と、出るメッセージ(実測)
返ってきたもの出たメッセージ
CDNの「Access denied」ページUnexpected token '<', "<!DOCTYPE "... is not valid JSON
フレームワークのデバッグ画面Unexpected token '<', "<!DOCTYPE "... is not valid JSON
ログイン画面へのリダイレクト結果Unexpected token '<', "<!doctype "... is not valid JSON
Nginxの502ページUnexpected token '<', "<html>
<h"... is not valid JSON

上の3つは、ほぼ同じ文字列になります。 <!DOCTYPE で始まるHTMLは全部そうなるので、 エラーメッセージからは「404なのか、ログイン画面なのか、デバッグ画面なのか」が分かりません。

ここが、検索して出てくる解説の多くが止まっているところです。 「HTMLが返っています」までは誰でも分かる。問題はその先で、それはNetworkタブにしかありません。

Networkタブで3つだけ見る

開発者ツールのNetworkタブで、該当のリクエストを選んで、次の3つだけ見てください。

表8:Networkタブで見る3点
見る場所何が分かるか判断
Status404 / 500 / 200404ならURL、500ならサーバー側、200なら下の2つへ
Response(Previewではなく生のほう)返ってきたHTMLの中身そのものログインフォームが見えたらセッション切れ。SPAのindex.htmlならプロキシ設定
Response Headers の Content-Typetext/html か application/json かtext/html なら確定。サーバーは最初からHTMLを返すつもりだった

特にResponseタブで中身を自分の目で見るのが一番速いです。 エラーメッセージが見せてくれるのは先頭10文字だけですが、Responseには全部入っています。

HTML以外でよくある原因

「HTML以外でよくある原因」の内容を図にまとめたもの

レスポンスが空、または途中で切れた

Unexpected end of JSON input が出たら、こちらです。 このメッセージには引用部分がありません。見せるべき中身がないからです。

表9:Unexpected end of JSON input になるもの(実測)
渡したもの実務での原因
空文字 ""204 No Content、DELETEの成功応答、ボディを返さないAPI
空白だけ " "サーバーが改行だけ返している
途中で切れた {"a":1,"b":通信の中断、タイムアウト、出力バッファの途中終了

204 No Content を返すAPIを res.json() に通すと必ずこれが出ます。 削除系のAPIで踏みがちです。ボディがないことが正常なので、パースする前に止めます。

すでにオブジェクトになっているものをparseした

"[object Object]" is not valid JSON はこれです。 文字列ではなくオブジェクトを JSON.parse に渡すと、JavaScriptが先に文字列化して [object Object] になり、それをパースしようとして落ちます。

典型例は、ライブラリが既にパースしてくれているのに気づかずもう一度パースするパターンです。

// axios は data を既にパース済みで返す
const res = await axios.get('/api/items');
const data = JSON.parse(res.data);   // ← ここで [object Object]

// 正しくは
const data = res.data;

// fetch の場合も、res.json() が既にパースしている
const res2 = await fetch('/api/items');
const data2 = JSON.parse(await res2.json());  // ← 同じ間違い

// 正しくは
const data2 = await res2.json();

関連して、よく似た値を渡したときの挙動も測りました。ここは直感と違います。

表10:紛らわしい値を JSON.parse に渡した結果(実測)
渡した値結果理由
JSON.parse(undefined)"undefined" is not valid JSON文字列 "undefined" に変換されてからパースされる
JSON.parse(null)エラーにならず null が返る文字列 "null" に変換され、それは妥当なJSON
JSON.parse('null')null が返る同上
JSON.parse({a:1})"[object Object]" is not valid JSONオブジェクトが文字列化される
JSON.parse(blob)Unexpected token 'o', "[object Blob]"...同上

JSON.parse(null) がエラーにならないのは罠です。 値がなかったのにエラーも出ず、後続で null を触って別の場所で落ちます。 エラーの発生場所と原因の場所がずれるので、追いにくくなります。

BOM・警告・デバッグ出力が混ざった

JSON自体は正しいのに、その前後に余計なものが付いているパターンです。 サーバー側のコードを触っているときによく出ます。

表11:混入パターンと、出るメッセージ(実測)
混入したものメッセージ原因
先頭にBOMUnexpected token '', ...(1文字目が見えない)PHPファイル等がUTF-8 BOM付きで保存されている
先頭にPHPの警告Unexpected token '<', "<br />
<b>"...
notice/warningがHTMLで出力されている
先頭にfatal errorUnexpected token 'P', "PHP Fatal "...例外が画面に出ている
末尾にゴミUnexpected non-whitespace character after JSON at position Nデバッグ用の出力、または二重にechoしている

BOMが厄介なのは、エラーメッセージを見ても何も見えないことです。 引用符の中に不可視の文字が入るだけなので、画面上は空白に見えます。 Unexpected token のあとの文字が読めないときは、BOMを疑ってください。

最後の行、after JSON at position N は他と性格が違います。 Nの位置までは正しいJSONとして読めた、ということなので、 そのNが正しいJSONの終端と一致していれば、原因は「後ろに何か余計なものが出ている」で確定します。

本当にJSONの文法が壊れている場合

「本当にJSONの文法が壊れている場合」の内容を図にまとめたもの

ここまでの原因を潰しても直らないなら、JSONそのものが不正です。 手書きのJSON、設定ファイル、他システムからの受け取りで起きます。

表12:JSONの文法エラー(実測)
書き方メッセージJSONでの正解
{"a":1,}(末尾カンマ)Expected double-quoted property name in JSON at position 7カンマを削る
[1,2,](配列の末尾カンマ)Unexpected token ']', "[1,2,]" is not valid JSONカンマを削る
{'a':1}(シングルクォート)Expected property name or '}' in JSON at position 1ダブルクォートにする
{a:1}(キーが裸)Expected property name or '}' in JSON at position 1キーをダブルクォートで囲む
{"a":NaN}Unexpected token 'N', "{"a":NaN}" is not valid JSONnull にする。JSONに NaN はない
{ // memo
"a":1 }
(コメント)
Expected property name or '}' in JSON at position 3コメントを削る。JSONにコメントはない

末尾カンマとシングルクォートは、JavaScriptでは通るのにJSONでは通りません。 エディタでJSファイルとして開いていると気づきにくいので、 .json として保存してエディタに検証させるのが早いです。

なお、コメント付きのJSON(JSONC)や末尾カンマを許す書き方は、 VS Codeの設定ファイルなど一部のツールが独自に許しているだけで、 JSON.parse は受け付けません。同じ感覚で書くと落ちます。

fetchで二度と踏まないようにする

「fetchで二度と踏まないようにする」の内容を図にまとめたもの

原因が分かったら、次は「同じことが起きても、意味の分かるエラーが出る」状態にします。 res.json() をそのまま呼ばないのがコツです。

async function getJson(url, options) {
  const res = await fetch(url, options);

  // 1. ステータスを先に見る
  //    404や500でも fetch は例外を投げない
  if (!res.ok) {
    const body = await res.text();
    throw new Error(
      `HTTP ${res.status} ${res.statusText} / ${url}\n` +
      body.slice(0, 300)
    );
  }

  // 2. 204など、ボディがないケースを先に抜く
  if (res.status === 204) return null;

  // 3. Content-Type を確認する
  //    200でHTMLが返るケース(ログイン画面・SPAのindex.html)はここで捕まる
  const ct = res.headers.get('content-type') || '';
  if (!ct.includes('application/json')) {
    const body = await res.text();
    throw new Error(
      `JSONではないレスポンス(Content-Type: ${ct}) / ${url}\n` +
      body.slice(0, 300)
    );
  }

  // 4. 自分でテキストを取ってからパースする
  //    こうするとエラー時に中身を全部ログに出せる
  const text = await res.text();
  if (text.trim() === '') return null;

  try {
    return JSON.parse(text);
  } catch (e) {
    throw new Error(
      `JSONのパースに失敗 / ${url}\n` +
      `先頭300文字: ${text.slice(0, 300)}`
    );
  }
}

ポイントは4番です。res.json() に任せると、 失敗したときに手元に残るのは先頭10文字だけのメッセージです。 自分で res.text() してからパースすれば、落ちたときに中身を全部ログに出せます。

表13:res.json() と自前パースの違い
res.json()res.text() してから JSON.parse
失敗時に分かること先頭10文字(... で切れる)レスポンス全文
404・500の扱い例外にならない。HTMLをパースして落ちるステータスで先に弾ける
204(空ボディ)Unexpected end of JSON inputnull を返して終われる
200でHTMLが返るケース気づけないContent-Typeで弾ける
本番での調査メッセージだけでは原因が絞れないログに中身が残る

サーバー側で出力を汚さない

「サーバー側で出力を汚さない」の内容を図にまとめたもの

フロント側で防ぐのと別に、サーバーがJSONだけを返す状態にするのも必要です。 JSONの前に警告が出る、エラー時にHTMLを返す、といった問題はサーバー側にしか直せません。

表14:サーバー側で確認すること
やること理由
APIのレスポンスに Content-Type: application/json を付けるフロント側でJSONかどうかを判定できるようになる
本番では警告・notice を画面に出さない(ログに流す)JSONの前にHTMLが混ざるのを防ぐ
エラー時もJSONで返す(エラーハンドラでJSONを出す)500でHTMLのデバッグ画面が返るのを防ぐ
ソースファイルをBOMなしUTF-8で保存する出力の先頭にBOMが混ざるのを防ぐ
閉じタグの後ろに余計な改行・出力を置かないJSONの末尾にゴミが付くのを防ぐ
認証切れは401をJSONで返す(ログイン画面にリダイレクトしない)200+HTMLという一番たちの悪いケースを消せる

最後の行が効きます。APIで認証切れのときにログイン画面へリダイレクトする設計をやめると、 「ステータス200でHTMLが返ってくる」という、フロントからは原因が見えないケースが丸ごと消えます。

AIに投げるときのコツ

「AIに投げるときのコツ」の内容を図にまとめたもの

このエラーはAIに投げやすい部類です。ただし、渡す情報を間違えると見当外れの答えが返ります。

表15:AIへの渡し方
渡すもの向くか理由
エラーメッセージだけ向かない先頭10文字しか情報がない。「HTMLが返っています」で終わる
Networkタブの Response 全文+ステータス+Content-Type向くログイン画面かデバッグ画面かをAIが読み分けられる
壊れたJSON本体を貼って「どこが不正か」向く文法チェックは確実。長いJSONほど効く
「fetchのラッパーを書いて」向く定型なので精度が高い。上のコードのような形が出る
「このエラーメッセージの形式はどのブラウザ?」向かない形式が変わった前後の情報が混ざる。表5で引く
サーバー側のコードを貼って「出力を汚しているところを探して」向くBOM以外の混入はコードを読めば見つかる

BOMだけはAIに見つけられません。 貼り付けた時点で不可視文字が落ちるからです。 ファイルの先頭バイトを自分で確認してください。

よくある質問

検索して出てきた解説と、エラーメッセージの形が違います

V8がメッセージの形式を変えたためです(表2)。 古い Unexpected token < in JSON at position 0 を前提にした記事が大量に残っています。 MDNの英語版リファレンスも古い形式のままです。手元の文字列を正として、表1で引いてください。

エラーの末尾の「...」は何ですか

切り詰められた印です。レスポンスが21文字以上あり、先頭10文字しか表示されていません(表3)。 中身を全部見るには、Networkタブの Response を開くか、 res.text() で自分で取ってログに出します(コード)。

ステータスは200なのにHTMLが返ってきます

セッション切れでログイン画面にリダイレクトされているか、 SPAのフォールバックで index.html が返っているかのどちらかが多いです(表6)。 Networkタブの Response を見れば、どちらかはすぐ分かります。

「[object Object] is not valid JSON」とは

文字列ではなくオブジェクトを JSON.parse に渡しています。 axios の res.data や fetch の res.json() は すでにパース済みなので、もう一度パースする必要はありません(詳しく)。

「Unexpected end of JSON input」が出ます

レスポンスが空か、途中で切れています(表9)。 204 No Content を返すAPIを res.json() に通すと必ずこれになります。 パースの前に res.status === 204 と空文字を弾いてください。

JSON.parse(null) がエラーになりません

仕様どおりです。null は文字列 "null" に変換され、それは妥当なJSONなので null が返ります(表10)。 値がなかったのにエラーも出ないので、後続の別の場所で落ちます。 パース前に値の有無を確認してください。

エラーの文字が「<」ではなく「o」なのはなぜですか

[object Blob] のような文字列の場合です。 [ はJSONの配列の開始として正しいので、エラーにはなりません。 その次の o で初めて破綻するので、報告される文字が o になります。

Firefoxだとメッセージが全然違います

エンジンが違うためです(表5)。 FirefoxのSpiderMonkeyは JSON.parse: ... at line N column M of the JSON data という形式で、 行と列を出します。長いJSONを手で直すときはこちらのほうが便利です。

JSONにコメントを書きたいのですが

JSON.parse は受け付けません(表12)。 VS Codeの設定ファイルなどで書けるのは、そのツールが独自にコメントを許しているからです。 末尾カンマも同じで、JSONの仕様にはありません。

まとめ

同じ「エラーメッセージの文字列から切り分ける」型の話は GA4でSPAのページビューが計測されない5つの原因 に書きました。 ブラウザ側にデータを持たせる話は localStorage の使い方と、2026年に気をつけること、 HTMLを取って中身を読む話は スクレイピングで要素を取得する にあります。

この記事のエラー文字列は2026年10月25日に Node 24.14.1 と Chrome 152 で実際にパースさせて取得したものです (SpiderMonkeyはMDNの記載、JavaScriptCore系は公開報告で、どちらも未実測)。 メッセージの文言はエンジンのバージョンで変わります。 手元に出ている文字列と違う場合は、手元のほうを正としてください。