公開後にJavaScriptが動かないときの原因と直し方

症状の確認：何が動いていないのかを切り分ける

まず「ページ全体が真っ白」なのか「一部のボタンだけ反応しない」のかを区別します。全体が真っ白な場合はスクリプトの読み込み自体に失敗している可能性が高く、一部だけ動かない場合は特定の処理でエラーが起きていると考えられます。

ブラウザの開発者ツール（多くのブラウザでF12キーで開けます）を開き、コンソールに赤いエラーが出ていないかを見てください。エラーの文言には、どのファイルが見つからないか、どの行で止まっているかのヒントが含まれています。

よくある原因：ファイルの置き忘れと相対パスのズレ

もっとも多いのは、HTMLだけをアップロードしてJavaScriptファイルを一緒に公開していないケースです。外部ファイルとして分けたスクリプトは、HTMLと同じ場所に存在しないと読み込めません。

次に多いのが相対パスのズレです。たとえば script src の指定が絶対パスやローカル固有のパスになっていると、公開環境では正しく解決されません。フォルダ構成を変えたのにパスを直し忘れている場合も同様です。

• HTMLにJavaScriptファイルを添付し忘れている
• script src が見つからない場所を指している
• ローカル専用の絶対パスが残っている
• 読み込み順が逆で、参照より先に処理が走っている

症状別チェック表

公開後にJavaScriptが動かないときは、症状を分けずに直そうとすると原因探しが長引きます。まず「自分だけで起きるのか」「全員で起きるのか」「特定ブラウザだけか」「差し替え後だけか」を切り分けます。

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

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

自分でできる確認：コンソールとネットワークを見る

開発者ツールのコンソールでエラー内容を確認したら、続けてネットワークタブを開いて、JavaScriptファイルのステータスを確認します。404と表示されていればファイルが見つかっていない、つまりパスかアップロード漏れが原因です。

また、HTTPSのページからHTTPの外部スクリプトを読み込もうとしてブロックされているケースもあります。混在コンテンツの警告がコンソールに出ていないかも合わせて確認してください。

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

原因の多くは「ファイルが揃っていない」か「パスが合っていない」のどちらかです。ギガサイト便ではZIPでまとめてアップロードすると、フォルダ構成と相対パスを保ったまま公開できるため、この種の問題を一気に解決できます。

以下の手順で公開し直してください。同じURLのまま中身を差し替えられるので、送付済みのURLを変えずに修正できます。

1. HTMLとJavaScript、関連ファイルを1つのフォルダにまとめる
2. HTML内のパスがそのフォルダ構成と一致しているか確認する
3. フォルダごとZIPに圧縮する
4. ギガサイト便のトップにZIPをドラッグ＆ドロップする
5. 認証方式と公開期限を設定して公開する
6. 発行されたURLを開き、開発者ツールでエラーが消えたか確認する

予防：作る段階で読み込みを揃えておく

再発を防ぐには、最初から関連ファイルを同じフォルダにまとめ、相対パスで書く習慣をつけるのが有効です。絶対パスやローカル固有のパスは公開時に壊れやすいため避けます。

公開前にローカルでフォルダごと開き、開発者ツールでエラーが出ないことを確認してからZIP化すると、公開後のトラブルをほぼ防げます。差し替えのたびに同じチェックを行うと安心です。