「Unexpected token '<' ... is not valid JSON」の原因と直し方 — エラー文字列から逆引きする
先に結論:エラー文字列の逆引き表
JSON.parse のエラーは、メッセージの文字列を読めば原因がほぼ決まります。
デバッガを起動する前に、まず表を引いてください。
下の表は、Node 24.14.1 と Chrome 152 で実際にパースさせて、出力された文字列をそのまま並べたものです。 どちらもV8なので、出るメッセージは完全に同じでした。
| エラー文字列 | 渡された中身 | よくある原因 |
|---|---|---|
Unexpected token '<', "<!DOCTYPE "... is not valid JSON | HTMLページ | 404・500・ログイン画面・プロキシのエラーページ(詳しく) |
Unexpected token '<', "<html> | DOCTYPEなしのHTML | Nginx/Apacheが直接返したエラーページ |
Unexpected token '<', "<br /> | PHPの警告+JSON | notice/warningがJSONの前に出力された |
Unexpected token 'P', "PHP Fatal "... is not valid JSON | PHPの致命的エラー | 例外が握り潰されず画面に出ている |
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 JSON | Blob・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 JSON | NaN / Infinity | サーバー側のシリアライズ |
Unexpected token '', ...(見えない文字) | BOM付きの文字列 | ファイルがUTF-8 BOM付きで保存されている |
Unexpected non-whitespace character after JSON at position N | 正しいJSONの後ろにゴミ | 二重出力・デバッグ用の print が残っている |
一番多いのは表の1行目です。「JSONを頼んだのにHTMLが返ってきている」という、 JSONの文法とは何の関係もない話が、ほとんどを占めます。
エラーメッセージの読み方
メッセージの形式は途中で変わった
このエラーを検索して、出てきた解説と手元のメッセージが噛み合わないことがあります。理由は単純で、 V8がメッセージの形式を変えたからです。
| メッセージ | 分かること | |
|---|---|---|
| 古い形式 | 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で引いてください。
引用符の中身が、返ってきた本物
新しい形式のいいところは、引用符の中にレスポンスの実物が入っていることです。 ここが診断の材料になります。
ただし全部は見えません。切り詰めのルールがあります。 これも実測で境界を特定しました。
| レスポンスの長さ | 表示 | 例 |
|---|---|---|
| 20文字以下 | 全文がそのまま出る | "<aaaaaaaaaaaaaaaaaaa" is not valid JSON |
| 21文字以上 | 先頭10文字+... | "<aaaaaaaaa"... is not valid JSON |
末尾に ... が付いていたら、レスポンスは21文字以上あって、先頭10文字しか見えていません。
実務で出るHTMLはどれも長いので、ほぼ必ず ... が付きます。
だからエラーメッセージだけで原因を決め切ることはできません。中身を見にいく必要があります。
もうひとつ、V8には例外的な挙動があります。
| 渡した文字列 | 出るメッセージ |
|---|---|
[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 なのは、そういう理由です。
エンジンごとに文字列が違う
同じ原因でも、ブラウザによってメッセージが全く違います。検索するときはここでハマります。
| エンジン | 使われている場所 | 形式 | 出典 |
|---|---|---|---|
| V8 | Chrome / Edge / Node.js | Unexpected token '<', "..."... is not valid JSON | 手元で実測(Node 24.14.1 / Chrome 152) |
| SpiderMonkey | Firefox | JSON.parse: unexpected character at line 1 column 1 of the JSON data | MDNのエラーリファレンス |
| JavaScriptCore系 | Safari など | JSON Parse error: Unexpected identifier "..." | 公開されている不具合報告(未実測) |
SpiderMonkeyは at line N column M of the JSON data という形で行と列を出します。
行数の多いJSONを手で直すときはFirefoxで開くほうが速いことがあります。
JavaScriptCore系の文字列は手元で実測していません。 公開されている不具合報告で繰り返し同じ形式が出ているため載せましたが、 Safariで出た文字列を正としてください。
一番多い原因:JSONを頼んだのにHTMLが返っている
なぜHTMLが返るのか
fetch や axios でAPIを叩いたとき、サーバーは常にJSONを返すとは限りません。
何か想定外のことが起きると、多くの環境はHTMLのエラーページを返します。
そのHTMLを JSON.parse に渡すと、1文字目の < で落ちます。
| 状況 | 返ってくるもの | 気づき方 |
|---|---|---|
| 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をパースさせてみました。結果はこうです。
| 返ってきたもの | 出たメッセージ |
|---|---|
| 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> |
上の3つは、ほぼ同じ文字列になります。
<!DOCTYPE で始まるHTMLは全部そうなるので、
エラーメッセージからは「404なのか、ログイン画面なのか、デバッグ画面なのか」が分かりません。
ここが、検索して出てくる解説の多くが止まっているところです。 「HTMLが返っています」までは誰でも分かる。問題はその先で、それはNetworkタブにしかありません。
Networkタブで3つだけ見る
開発者ツールのNetworkタブで、該当のリクエストを選んで、次の3つだけ見てください。
| 見る場所 | 何が分かるか | 判断 |
|---|---|---|
| Status | 404 / 500 / 200 | 404ならURL、500ならサーバー側、200なら下の2つへ |
| Response(Previewではなく生のほう) | 返ってきたHTMLの中身そのもの | ログインフォームが見えたらセッション切れ。SPAのindex.htmlならプロキシ設定 |
| Response Headers の Content-Type | text/html か application/json か | text/html なら確定。サーバーは最初からHTMLを返すつもりだった |
特にResponseタブで中身を自分の目で見るのが一番速いです。 エラーメッセージが見せてくれるのは先頭10文字だけですが、Responseには全部入っています。
HTML以外でよくある原因
レスポンスが空、または途中で切れた
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();
関連して、よく似た値を渡したときの挙動も測りました。ここは直感と違います。
| 渡した値 | 結果 | 理由 |
|---|---|---|
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自体は正しいのに、その前後に余計なものが付いているパターンです。 サーバー側のコードを触っているときによく出ます。
| 混入したもの | メッセージ | 原因 |
|---|---|---|
| 先頭にBOM | Unexpected token '', ...(1文字目が見えない) | PHPファイル等がUTF-8 BOM付きで保存されている |
| 先頭にPHPの警告 | Unexpected token '<', "<br /> | notice/warningがHTMLで出力されている |
| 先頭にfatal error | Unexpected 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での正解 |
|---|---|---|
{"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 JSON | null にする。JSONに NaN はない |
{ // memo(コメント) | Expected property name or '}' in JSON at position 3 | コメントを削る。JSONにコメントはない |
末尾カンマとシングルクォートは、JavaScriptでは通るのにJSONでは通りません。
エディタでJSファイルとして開いていると気づきにくいので、
.json として保存してエディタに検証させるのが早いです。
なお、コメント付きのJSON(JSONC)や末尾カンマを許す書き方は、
VS Codeの設定ファイルなど一部のツールが独自に許しているだけで、
JSON.parse は受け付けません。同じ感覚で書くと落ちます。
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() してからパースすれば、落ちたときに中身を全部ログに出せます。
res.json() | res.text() してから JSON.parse | |
|---|---|---|
| 失敗時に分かること | 先頭10文字(... で切れる) | レスポンス全文 |
| 404・500の扱い | 例外にならない。HTMLをパースして落ちる | ステータスで先に弾ける |
| 204(空ボディ) | Unexpected end of JSON input | null を返して終われる |
| 200でHTMLが返るケース | 気づけない | Content-Typeで弾ける |
| 本番での調査 | メッセージだけでは原因が絞れない | ログに中身が残る |
サーバー側で出力を汚さない
フロント側で防ぐのと別に、サーバーがJSONだけを返す状態にするのも必要です。 JSONの前に警告が出る、エラー時にHTMLを返す、といった問題はサーバー側にしか直せません。
| やること | 理由 |
|---|---|
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に投げやすい部類です。ただし、渡す情報を間違えると見当外れの答えが返ります。
| 渡すもの | 向くか | 理由 |
|---|---|---|
| エラーメッセージだけ | 向かない | 先頭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の仕様にはありません。
まとめ
- まず 表1 でエラー文字列を引く。文字列を読めば原因はほぼ決まる。
- 一番多いのは
Unexpected token '<', "<!DOCTYPE "...。JSONを頼んだのにHTMLが返っている。JSONの文法の問題ではない。 - 末尾の
...は先頭10文字しか見えていない印。21文字以上で切り詰められる。メッセージだけで決め切らない。 - 404なのかログイン画面なのかデバッグ画面なのかは、エラーメッセージからは区別できない。Networkタブの Status / Response / Content-Type の3つを見る。
"[object Object]"はパース済みのものを再度パースしている。axiosもres.json()も既にパース済み。Unexpected end of JSON inputは空か途中で切れている。204をres.json()に通すと必ず出る。JSON.parse(null)はエラーにならない。落ちる場所と原因の場所がずれる。- 再発を防ぐなら
res.json()を直接呼ばず、res.text()してから自分でパースする。失敗時に全文をログに残せる。 - サーバー側は認証切れを401のJSONで返す。「200+HTML」という一番たちの悪いケースが消える。
同じ「エラーメッセージの文字列から切り分ける」型の話は GA4でSPAのページビューが計測されない5つの原因 に書きました。 ブラウザ側にデータを持たせる話は localStorage の使い方と、2026年に気をつけること、 HTMLを取って中身を読む話は スクレイピングで要素を取得する にあります。
この記事のエラー文字列は2026年10月25日に Node 24.14.1 と Chrome 152 で実際にパースさせて取得したものです (SpiderMonkeyはMDNの記載、JavaScriptCore系は公開報告で、どちらも未実測)。 メッセージの文言はエンジンのバージョンで変わります。 手元に出ている文字列と違う場合は、手元のほうを正としてください。