外部CDNのCSS・JSが読み込めないときの対処

症状の確認：崩れか無反応かを見る

デザインが崩れている場合はCSSの読み込みに失敗している可能性が高く、ボタンや動きが反応しない場合はJavaScriptの読み込みに失敗していると考えられます。どちらが効いていないかで原因の見当が変わります。

開発者ツールのネットワークタブを開き、CDNから読み込むファイルが正常に取得できているか、エラーになっていないかを確認してください。これが切り分けの基本です。

よくある原因：URLの誤りと混在コンテンツ

もっとも多いのは、CDNのURLが間違っている、または古くて存在しなくなっているケースです。バージョン番号の指定ミスやタイプミスで404になっていることがあります。

次に多いのが、HTTPSのページからHTTPのCDNを読み込もうとして混在コンテンツとしてブロックされる問題です。また、ローカルでファイルを開いて確認していたときには動いていたものが、公開環境では別の挙動になることもあります。

• CDNのURLが間違っている、または古い
• バージョン指定が存在しないものになっている
• HTTPのCDNを読み込んでブロックされている
• 読み込み順が逆でライブラリ未定義のまま処理が走る

症状別チェック表

外部CDNのCSS・JSが読み込めないは、症状を分けずに直そうとすると原因探しが長引きます。まず「自分だけで起きるのか」「全員で起きるのか」「特定ブラウザだけか」「差し替え後だけか」を切り分けます。

確認順序を固定すると、相対パス、ファイル名、キャッシュ、認証、外部読み込みのどこで止まっているかが見えます。修正後はローカル確認だけで終わらせず、実際の共有URLで再表示して、相手と同じ条件で直ったことを確認します。

• 自分だけ表示されない: キャッシュ、ログイン状態、ブラウザ拡張、端末幅を確認する
• 全員で表示されない: ファイル構成、相対パス、大文字小文字、アップロード漏れを見る
• 一部だけ崩れる: CSS/画像/JSごとに読み込みエラーを分ける
• 差し替え後だけ古い: URL、キャッシュ、更新対象ファイルの取り違えを確認する

自分でできる確認：ネットワークタブで状態を見る

ネットワークタブでCDNのファイルが404やブロックになっていないか確認します。404ならURLの誤り、ブロックなら混在コンテンツが疑われます。

URLを直接ブラウザのアドレスバーに貼り付けて開いてみると、そのファイルが実在するか手早く確認できます。表示されなければURLが間違っています。HTTPSのURLになっているかも合わせて見ておきましょう。

ギガサイト便での対処手順

CDNに依存せず確実に動かしたい場合は、CSSやJavaScriptのファイルをダウンロードして自分のZIPに同梱し、相対パスで読み込む方法が有効です。これなら外部の都合に左右されず安定します。

以下の手順で見直してください。CDNを使い続ける場合はHTTSのURLに統一します。

1. 必要なCSS・JSファイルをダウンロードしてフォルダにまとめる
2. HTMLの読み込み先を相対パスに書き換える
3. CDNを使う場合はHTTPSのURLに統一する
4. ライブラリの読み込み順が正しいか確認する
5. フォルダごとZIPに圧縮してギガサイト便で公開する
6. 発行URLを開いてデザインと動作を確認する

予防：依存ファイルは同梱して安定させる

共有先の環境やネットワークによっては外部CDNにアクセスできないこともあります。重要なページでは、依存するCSSやJavaScriptをZIPに同梱しておくと、外部要因に左右されず安定して表示できます。

CDNを使う場合でも、必ずHTTSのURLにそろえ、公開前にネットワークタブで全ファイルが正常に読み込まれることを確認してから公開する習慣をつけましょう。