AIO対策チェック

JSON-LDバリデーションエラーの解消法10選

Schema.orgの実装でよくあるミスとその修正方法をエンジニアが解説。

JSON-LDバリデーションエラーの解消法10選

この記事の要点

  • よくあるエラー10種:必須プロパティ欠落、日付形式、URL形式など

  • 検証ツール:Google Rich Results Test、Schema.org Validator

  • 修正フロー:エラー特定→原因分析→修正→再テスト

  • 予防策:テンプレート化、CMSプラグイン活用

JSON-LDエラーの全体像

構造化データ(JSON-LD)実装時のエラーは、Google Rich Results TestやSearch Consoleの「拡張」セクションで検知されます。エラーがあるとリッチリザルトが表示されず、SGE引用率も低下します。

エラーは大きく分けて以下の3種類があります:

  • 構文エラー:JSONの文法ミス(カンマ、クォート等)

  • スキーマエラー:必須プロパティ欠落、型の不一致

  • 内容エラー:実ページ内容との不一致

エラー解消の基本フロー

  1. 検証:Google Rich Results TestでURLまたはコードをテスト

  2. エラー特定:エラーメッセージを確認

  3. 原因分析:下記の10選から該当するものを特定

  4. 修正:コードを修正

  5. 再テスト:修正後、再度検証

  6. 反映確認:Search Consoleで1〜3日後に確認

よくあるエラー10選と修正法

#エラー種別原因修正ステップ 1 必須プロパティ欠落 headline、name、acceptedAnswer等がない Googleドキュメントで必須項目を確認し追加 2 日付形式誤り 2026/1/6など非ISO8601形式 YYYY-MM-DD形式(2026-01-06)に統一 3 URL形式問題 相対パス(/page/)やhttp:// https://から始まる絶対URLに変更 4 データ型不一致 文字列を数値扱い、配列を非配列 プロパティの型定義を確認し修正 5 スキーマタイプ誤用 ArticleにProductのpriceプロパティ 適切なスキーマタイプに変更 6 ページ内容との不一致 headlineと実タイトルが違う 構造化データを実ページ内容と同期 7 重複マークアップ MicrodataとJSON-LDの二重定義 1形式(JSON-LD推奨)に統一 8 非推奨プロパティ 廃止されたフィールドを使用 Schema.org最新版で確認し更新 9 JSON構文エラー カンマ・クォート欠落、閉じ括弧不足 JSONLint等でバリデート後修正 10 配列/オブジェクト誤り mainEntityが配列でない(FAQPage) スキーマ仕様を確認し構造修正

エラー別の詳細解説

1. 必須プロパティ欠落

最も多いエラーです。各スキーマタイプには必須プロパティがあります。

// NG: authorがない
{
  "@type": "Article",
  "headline": "タイトル"
}

// OK: 必須プロパティを追加
{
  "@type": "Article",
  "headline": "タイトル",
  "author": {"@type": "Person", "name": "著者名"},
  "datePublished": "2026-01-06"
}

2. 日付形式誤り

日付はISO 8601形式で記載します。

// NG
"datePublished": "2026/1/6"
"datePublished": "January 6, 2026"

// OK
"datePublished": "2026-01-06"
"datePublished": "2026-01-06T12:00:00+09:00"

3. URL形式問題

// NG
"url": "/article/sample"
"url": "http://example.com/article"

// OK
"url": "https://example.com/article/"

9. JSON構文エラー

JSONLint(jsonlint.com)でチェックしましょう。

// NG: 最後のカンマが余分、クォートが不正
{
  "name": "テスト",
  "url": "https://example.com",  // ← 最後のカンマ不要
}

// OK
{
  "name": "テスト",
  "url": "https://example.com"
}

検証ツール一覧

ツール用途URL Google Rich Results Testリッチリザルト対応確認search.google.com/test/rich-results Schema.org Validator構文・スキーマ検証validator.schema.org JSONLintJSON構文チェックjsonlint.com

よくある質問(FAQ)

Q: エラーがあっても検索結果に出ますか?

A: 通常の検索結果には表示されますが、リッチスニペット(FAQ表示、星評価等)は表示されません。SGE引用率も低下する可能性があります。

Q: Search Consoleへの反映はどのくらいかかりますか?

A: 通常1〜3日です。「URL検査」→「インデックス登録をリクエスト」で優先的にクロールを依頼できます。

Q: 警告は修正すべきですか?

A: 警告(Warning)は必須ではありませんが、推奨プロパティを追加することでリッチリザルトの表示品質が向上します。

まとめ:エラー解消チェックリスト

  • ☑ Google Rich Results Testでエラー確認

  • ☑ 必須プロパティ(headline, author, datePublished等)を追加

  • ☑ 日付はISO 8601形式(YYYY-MM-DD)

  • ☑ URLはhttps://絶対パス

  • ☑ JSONLintで構文チェック

  • ☑ 修正後、再テストで「有効」を確認

  • ☑ Search Consoleで反映を確認

あなたのサイトのAIO対策を診断してみませんか?

無料でGoogle SGEへの引用可能性をチェックできます

無料診断ツールを試す