SPA をリロードすると 404 になるときの解決法
最終更新: 2026-11-11
結論から言うと、サイト設定 ▸ サイトの[詳細]で「存在しないURLでもメインページを開く(アプリ型サイト向け)」をオンにすれば、React・Vue サイトへの直リンクやリロードが 404 ではなくアプリとして開きます。ただしオンにすると「存在しないURLで表示するページ」は通常のURLでは使われないので、サイトに合う方だけを使ってください。
ひと目でわかる
- 所要時間
- 約2分
- 必要なプラン
- 無料プランでOK
- コードの知識
- 不要
- 操作する場所
- エディタ
手順
- 1
ビルドした出力フォルダをアップロードする
React・Vue・Vite のサイトは、ビルドコマンドで出力されたフォルダ(たいてい dist)を ZIP にまとめるか、フォルダごとアップロードします。この種のサイトは index.html がほぼ空で、スクリプトが画面を描きます。そのため /about のようなURLにはファイルがなく、設定がオフだとそのURLを直接開いたりリロードしたりしたときに 404 になります。
index.html<!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script> - 2
SPA の設定がオンか確認する
ZIP・フォルダ・GitHub でアップロードした直後に、ファイルがこのようなアプリ構成だとはっきり分かると、設定は自動でオンになりエディターが知らせます。自分で確認するなら、左側の設定 ▸ サイト設定 ▸ サイトで[詳細]を開き、「存在しないURLでもメインページを開く(アプリ型サイト向け)」をオンにします。変更は自動で保存され、公開し直さなくてもすぐ反映されます。
サイト設定 ▸ サイト ▸ [詳細]の中に SPA のスイッチがあります - 3
直リンクとリロードで確かめる
自分のアドレスの後ろにアプリのパスを付けて開き、リロードしてみてください。404 ではなくアプリの画面が出れば完了です。メインページが開くのは画面用のURL(拡張子のないURL)だけで、画像やスクリプトのように拡張子のあるファイルが存在しないときは、そのまま 404 になります。
myname.html2site.com/about 公開中スイッチをオンにすると、このURLをリロードしてもアプリが開きます
- 4
404 ページと併用するなら片方を選ぶ
「存在しないURLで表示するページ」は、サイト設定 ▸ サイトで、このサイトにあるページから選びます(選ばないと標準の404ページ)。複数ページの通常サイトならこちらが正解で、SPA のスイッチはオフのままにします。スイッチをオンにすると存在しないURLもメインページが開くため、404 ページは使われません。アプリの中で「ページが見つかりません」を出したいなら、アプリのルーターに作ってください。
サイト設定 ▸ サイト存在しないURLで表示するページ 標準の404ページ存在しないURLでもメインページを開く ON
よくある質問
React アプリをリロードすると 404 になるのはなぜですか?
SPA はURLごとにファイルがあるわけではなく、ブラウザ内のスクリプトがURLを見て画面を描きます。静的ホスティングはURLと同じ名前のファイルを探し、/about にはないので 404 になります。SPA の設定をオンにすると、そのURLにもメインページが返り、アプリが引き継ぎます。
SPA の設定は自分でオンにする必要がありますか?
ZIP・フォルダ・GitHub でアップロードした直後に、ファイルがアプリ構成(空のメインページにスクリプトが画面を描く構成など)だとはっきり分かれば自動でオンになります。判断材料が弱いときは、サイト設定の[詳細]に理由つきでオンにする提案が出ます。どちらの場合もスイッチで自由にオン・オフできます。
通常のサイトでもオンのままで問題ありませんか?
おすすめしません。オンだと打ち間違いのURLもすべてメインページが開き、「存在しないURLで表示するページ」が使われず、検索エンジンも存在しないURLを通常のページと見なすことがあります。ページごとにファイルがあるサイトはオフが適切です。
SPA サイトで「ページが見つかりません」の画面は出せますか?
この設定は存在しないURLをメインページに回すものなので、その画面はアプリのルーターで作る必要があります。404 ページを使いたいサイトは、スイッチをオフにして「存在しないURLで表示するページ」を選んでください。
オンにしたのに 404 が出るときはどうしますか?
まずファイル一覧にメインページ(index.html)があるか確認してください。ないと開く画面がなく 404 になります。また .js や .png のように拡張子のあるURLは、ファイルがなければ 404 になるのが正しい動作です。アプリが読み込むファイルのパスが合っているか確かめてください。
あわせて読みたい
- サイトのフォルダーをZIPでアップロードして自分のURLにする方法 CSS・JS・画像・複数ページがあるサイトを、ZIPまたはフォルダーごと無料で自分のURLに公開する手順ガイド(日本語)
- GitHubリポジトリを取り込んで静的サイトとして公開する方法 公開GitHubリポジトリの静的ファイルを取り込み、無料で自分のURLに公開する手順ガイド。ビルドなし、index.html が必要(日本語)
- 公開したサイトを以前のバージョンに戻す方法 公開したサイトを以前のバージョンに戻す方法 — 確認、復元、復元の取り消し、無料とPlusで残る範囲(日本語)
- 独自ドメインをサイトにつなぐ方法 公開したHTMLサイトに取得済みの独自ドメインをつなぐ手順ガイド(アドレス入力・CNAMEとTXTの追加・接続確認・HTTPS自動、Plusから)