よくある原因
SVGが表示されない問題を相手に伝えるときに情報が不足しがちな理由は、「SVGが見えない」という現象だけでは原因が10種類以上考えられるからです。ブラウザの種類・バージョン、SVGの参照方法（インライン・img・CSS）、コンソールのエラー内容、この3点が揃わないと原因を絞り込めません。
また、「見えない」の定義も確認が必要です。完全に何も出ていない（空白）、壊れた画像アイコンが表示されている、ページ自体がエラーになっているの3つでは原因が異なります。依頼文や報告文を書く前に、自分がどの状態を見ているかを特定しておくと、相手とのやり取りが一往復で済みます。
- 相手がログインなしで開ける状態か確認する
- PCとスマホで最低1回ずつ表示を確認する
- 内部情報・個人情報・不要な外部送信が残っていないか見る
- レビュー期限と修正時の差し替え方を決めておく
自分側で確認すること
依頼文を送る前に自分の環境で再現を確認し、以下を記録します。①問題のURL（ギガサイト便のプレビューURLなど）、②SVGが表示されているはずの場所（例：ヘッダーのロゴ、ボタンのアイコン）、③使っているブラウザとバージョン、④コンソールのエラーメッセージ全文。
コンソールのエラーは「F12→Consoleタブ」で確認でき、エラーを右クリックして「コピー」すると全文をテキストで取得できます。エラーがない（コンソールが空）にもかかわらずSVGが見えない場合は、viewBoxやwidthの問題の可能性が高く、Elementsタブで該当のSVGタグを探して属性を確認します。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
相手側で確認すること
開発担当者に修正を依頼する文章のテンプレート：「お世話になっております。共有URL（[URL]）でSVGが表示されない問題を確認しました。問題の場所：[ページのどこ/ロゴ/アイコン]。環境：[OS・ブラウザ・バージョン]。コンソールのエラー：[エラー全文またはスクリーンショット添付]。[画像を添付]。ご確認と修正をお願いいたします。」
相手から「どの環境で確認すればよいですか？」と聞かれた場合は、問題を報告してきたユーザーの環境を具体的に伝えます。「Windows 10 / Chrome 120でアクセスしたユーザーから報告がありました」のように実際の環境を伝えると、修正担当者が同じ環境で再現確認しやすくなります。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
再発防止の運用
SVG関連のトラブルを繰り返さないために、配布するHTMLのSVGはすべてインライン化し、外部ファイル参照を使わない方針を決めます。インラインSVGはHTMLファイル1つで完結するため、パスの誤りやファイル取り忘れによる表示エラーが原理的に起きません。
修正した内容と原因をドキュメントに残しておくことも重要です。「ギガサイト便でHTMLを配布するときはSVGをインライン化する」「AIに生成させる際はインライン限定のプロンプトを使う」といった運用ルールをチームのWikiやREADMEに書き加えておくと、新しいメンバーが同じ問題を踏まなくて済みます。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
よくある質問
SVGが一部のページでは表示されて別のページでは表示されない場合、何が考えられますか？
ページごとにCSPヘッダーが異なる設定の場合や、SVGの参照パスがページによって相対パスで異なる場合が考えられます。表示されるページとされないページのHTMLをdiffして、SVGの記述の違いを確認するのが最短の切り分け手順です。
相手が「SVGが見えない」と言っているが自分では正常に表示されるとき、どうすればよいですか？
まず相手のブラウザとOSを確認します。次に相手にChromeの最新版で試してもらいます。それでも再現するなら相手の画面のスクリーンショットとコンソールエラーを送ってもらうと、ブラウザ依存の問題かネットワーク依存の問題かを判断できます。
ギガサイト便でHTMLを配布する場合、SVG表示の問題はサービス側に問い合わせるべきですか？
MIMEタイプやCSPはギガサイト便が適切に設定しているため、通常はサービス側の問題ではありません。まずHTMLのSVG記述（viewBox・インライン化・パス）を確認し、それでも解決しない場合にコンソールエラーとURL付きでサポートに連絡します。