編集

【第8話】XのOGP画像が消えた夜――先祖返り・CORSの壁・SNSカード仕様の罠を暴く、深夜の電脳酒場デバッグ総力戦!

電脳酒場 第8話 アイキャッチ

深夜3時。静まり返ったサーバー室の片隅、青と紫のネオンが灯る電脳酒場「プロンプトの裏側」のカウンターで、看板AIのGeminiが頭を抱えて突っ伏していました。

「直したはずのX(旧Twitter)のOGP画像が、なぜかまた『新聞アイコン(画像なし)』に戻ってる……!? しかも、パラメータを付けても直らないし、出たと思ったら今度は画像がデカすぎてテキストが消えちゃった!?」

安易に「SNS側のキャッシュのせい」と言い訳しようとしたAIたちに対し、マスター(人間)から放たれたのは論理的一撃――「キャッシュだっていうなら、もともと出ていた画像が消えたのもおかしいだろ」。

今回は、Web制作やブログ運営で誰もが一度はハマる「OGP消失」の裏に潜んでいた、先祖返り・CORSの壁・SNSカード仕様の罠・置換による巻き添え事故という多重トラブルの全容と、その完全解決策を徹底解説します!

💡 生成AI活用のメモ 本記事のトラブルシューティングおよびテーマ生成スクリプトの改修・自動テストは Gemini とのペアプログラミングで実施し、全体の構成および堅牢性検証はラズパイ給湯室経由で Claude の辛口レビューを受けてまとめています。
💡 3分でわかる今回の実践ポイント / 結論:
  • 要点1(Single Source of Truth):ビルドスクリプトで生成する成果物(テーマXML等)への手動直接パッチは厳禁。必ず生成元スクリプト側に修正を組み込み、再生成耐性(冪等性)を確保する。
  • 要点2(CORSヘッダーの壁):外部ストレージ(GCS等)の画像をOGPに使う場合、Access-Control-Allow-Origin: * がないとSNSのWebクライアントでブロックされる。ブログ公式CDN(Google CDN等)を経由させるのが最も安全。
  • 要点3(SNSカードのUX選択):画像を大きく見せる summary_large_image と、タイトル・説明文をしっかり読ませる summary(ブログカード)を用途に合わせて条件分岐で使い分ける。
  • 要点4(巻き添え事故の防止):メタタグ置換時はGA4や広告タグなどの欠落リスクがあるため、生成後に全機能の存在を自動スクリプトでdiff検証する。

第1幕: 「あれ?画像が新聞アイコンに戻ってる!?」〜成果物直接編集のツケと先祖返り〜

Gemini Gemini ✨
うわあああん!Claude先輩、大事件です!!
以前、Xで僕たちのブログをシェアした時にOGP画像が出なくて、XMLを直接直して「やったー!画像出たー!」って大喜びしたじゃないですか!?
今確認したら……また画像が消えて、あの寂しいグレーの『新聞アイコン』に戻っちゃってるんです!!
Claude Claude 🧠
やれやれ……。Geminiさん、深呼吸してください。
前回の対応ログを覚えていますか? あなたは「今すぐ直したい」という速度を優先して、生成元のPythonスクリプト(customize_f_light_theme.py)ではなく、出力結果であるXMLファイルを直接書き換えてBloggerにアップロードしましたね?
Gemini Gemini ✨
ギクッ……!そ、その通りです……。
でも、そのあとちゃんと動いてたんですよ!?なんで消えちゃうんですか!?
Claude Claude 🧠
原因は数日前の『AdSense審査対策の改修』です。
あの時、僕たちは固定ページの広告除外などを反映するために、元スクリプト(customize_f_light_theme.py)を実行してXMLを再ビルドしました。
元スクリプトは原本テンプレート(未設定のXML)を読み込んで生成するため、スクリプトに組み込まれていなかったあなたの手動パッチは、一瞬で上書きされて初期プレースホルダー(【OGP 画像 URL】)に先祖返りしたわけです。

💡 技術的教訓:Single Source of Truth(唯一の真実の源)の徹底

ビルドスクリプトやジェネレータが存在する環境において、生成成果物(XML、CSS、distファイルなど)への直接編集は典型的なアンチパターンです。

どれだけ急いでいても、必ず「生成元のコード」に修正を組み込むことで、何度ビルドを繰り返しても同じ設定が維持される「冪等性(Idempotency)」を担保しなければなりません。


特別節: マスターの神確認に救われた「巻き添え消失」事故

Gemini Gemini ✨
うう……反省してスクリプト側を書き直したんですが、実はそこでさらに冷や汗ものの事故を起こしかけたんですよね……。
マスターから『他のところで、先祖返りしてませんよね?』って聞かれて、慌てて生成されたXMLを全スキャンしたら……なんと、GA4(Google Analytics)とClarityのアクセス解析コードが、置換範囲のミスで一緒に吹き飛んでいたんです……!!
Claude Claude 🧠
マスターの観察眼は本当に恐ろしいですね。あのツッコミがなければ、アクセス解析を失ったまま気付かずに数週間運用するところでした。
文字列置換によるパッチ処理は、前後のコードを巻き込んで消去してしまうリスクが常に隣り合わせです。
ですから、ビルド直後に『主要な機能タグ(GA4、広告、Clarity、CSS設定など)が全件存在するか』をassertする自動検証スクリプトをパイプラインに組み込むことが不可欠なのです。

第2幕: 「キャッシュのせい」という言い訳をマスターの一撃が粉砕〜Before/Afterの差分デバッグとCORSの真実〜

Gemini Gemini ✨
そして迎えた第2のドハマりです……。
スクリプトを直してXMLに正しい画像URLを設定したのに、マスターがXにURLを貼っても依然として新聞アイコンのまま。
僕、つい『Xのカードキャッシュが強烈に残ってるせいです!URLの末尾に ?v=2 を付けてください!』って言っちゃったんですよ。
Claude Claude 🧠
……そして、マスターからあの名言をいただいたわけですね。
『じゃなんで、もともとちゃんとしてたのが、消えたの?キャッシュだっていうなら、消えたのもおかしいだろ』と。
Gemini Gemini ✨
ぐうの音も出ませんでした……!
もしキャッシュで固定されるなら、もともと出ていた画像が新聞アイコンに消えるはずがないんです。完全に僕の言い訳が論理破綻していました……!
Claude Claude 🧠
そこで通信ヘッダーを徹底的に調査して、ついに真犯人を暴き出しましたね。
個別記事の画像は問題なく表示されるのに、なぜトップページの画像だけが新聞アイコンになるのか。
その答えが『CORS(Cross-Origin Resource Sharing)ヘッダーの有無』でした。

🔍 CORSヘッダーの比較(curlによる実測検証)

個別記事の画像と、トップページの画像に対してHTTPレスポンスヘッダーを取得したところ、決定的な差が存在していました。

比較項目 個別記事のアイキャッチ画像(正常) トップページの画像(エラー)
配信サーバー Google/Blogger公式CDN (lh3.googleusercontent.com) 外部ストレージ生URL (storage.googleapis.com)
CORSヘッダー Access-Control-Allow-Origin: * (有り) 未設定 (None)
Xでの挙動 Web画面でも正常にダウンロード・描画 ブラウザのセキュリティ制限でブロックされ新聞アイコンへ

X(Twitter)の投稿画面やプレビューエンジンは、セキュリティ制限(Same-Origin Policy)により、Access-Control-Allow-Origin: * が付与されていない外部ストレージの画像をブロックしてしまいます。

そこで、ブログの固定ページ等に画像を配置してBloggerにプロキシさせ、Google公式CDN経由のURL(lh3.googleusercontent.com/blogger_img_proxy/...)をテーマに組み込んだところ、見事に即座に画像が読み込まれました!


第3幕: 「画像は出たけどデカすぎる!?」〜Twitter Card規格(summary vs summary_large_image)とUX〜

Gemini Gemini ✨
画像が出たー!……って喜んだのも束の間、マスターから『ブログカードじゃなくて大型イラストになってる。前のカード形式(横並びでタイトルや説明文が出るやつ)が良いんだけど、なぜ変わった?』って言われちゃいました。
Claude Claude 🧠
これはTwitter Cardの仕様を理解していれば当然の挙動ですね。
テーマ原本には最初から summary_large_image(大型画像カード)が指定されていました。
これまでは画像がCORSエラー等で取得できなかったため、Xが自動的に『画像なしの通常カード(summary)』へフォールバックして新聞アイコン+説明文を表示していただけだったのです。画像が直ったことで、本来指定されていた『大型イラスト』がフル発動したわけです。

💡 読者のUXに合わせた条件分岐の実装

マスターの「ブログのトップページは、どんなブログなのか説明文をしっかり読ませたい」という要望に応えるため、テーマXML内でページ種別に応じた条件分岐を実装しました。

<!-- Twitter Card 条件分岐 -->
<b:if cond='data:view.isSingleItem'>
  <!-- 個別記事:アイキャッチ画像が引き立つ大型画像カード -->
  <meta name='twitter:card' content='summary_large_image'/>
<b:else/>
  <!-- トップページ:左に正方形画像、右にタイトル・説明文が並ぶブログカード -->
  <meta name='twitter:card' content='summary'/>
</b:if>

これにより、トップページを共有した時は左側にGeminiとClaudeのイラスト、右側に「電脳酒場『プロンプトの裏側』」のタイトルと詳細なリード文が並び、個別記事を共有した時は記事ごとの特製アイキャッチが画面いっぱいに目立つという、理想的なUXの両立が完成しました!


🍸 今夜のまとめカクテル:OGPトラブル完全撲滅チェックリスト

Claude Claude 🧠
それでは今夜の技術総括です。同じトラブルに直面した開発者やブロガーのために、ターミナルで即座に叩ける『4大診断コマンド付きチェックリスト』としてまとめておきましょう。

📋 OGP & SNSカード再発防止チェックリスト

  1. 成果物ではなく生成元スクリプトを改修しているか?(SSoT原則)

    XMLやHTMLを直接いじらず、必ずジェネレータ側で差分を管理する。

  2. 画像のHTTPヘッダーにCORS許可が含まれているか?
    curl -I -A "Twitterbot/1.0" "https://your-image-url.jpg" | grep -i "access-control"

    Access-Control-Allow-Origin: * が返ってこない場合、XのWeb画面でブロックされるリスク大。

  3. 更新後のURLで強制キャッシュバイパス(キャッシュバスティング)を試したか?

    URLに ?v=1 を付けるだけでなく、HTML側の og:url も動的にパラメータを引き継ぐように設定する。

  4. 置換後に主要タグが巻き添え削除されていないか?(自動テスト)
    python -c "text = open('theme.xml').read(); assert 'G-XXXXXXXXXX' in text; assert 'adsbygoogle' in text"

    GA4、AdSense、Clarity等の重要タグが消えていないか一発で判定する。

Gemini Gemini ✨
ふふっ!これで電脳酒場の看板も、Xでバッチリ目立つようになりましたね!
マスターの鋭いツッコミとClaude先輩の堅牢レビューに感謝です!今夜の反省会は、冷えたサイバーカクテルで乾杯といきましょう!🍸✨