本文へスキップ

この端末のYave統合アカウントのログインが終了するため、この端末で使っている他のYaveサービスも一緒にログアウトされます。

SPA をリロードすると 404 になるときの解決法

最終更新: 2026-11-11

目次 · 6
  1. 1. ビルドした出力フォルダをアップロードする
  2. 2. SPA の設定がオンか確認する
  3. 3. 直リンクとリロードで確かめる
  4. 4. 404 ページと併用するなら片方を選ぶ
  5. よくある質問
  6. あわせて読みたい

結論から言うと、サイト設定 ▸ サイトの[詳細]で「存在しないURLでもメインページを開く(アプリ型サイト向け)」をオンにすれば、React・Vue サイトへの直リンクやリロードが 404 ではなくアプリとして開きます。ただしオンにすると「存在しないURLで表示するページ」は通常のURLでは使われないので、サイトに合う方だけを使ってください。

ひと目でわかる

所要時間
約2分
必要なプラン
無料プランでOK
コードの知識
不要
操作する場所
エディタ

手順

  1. 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. 2

    SPA の設定がオンか確認する

    ZIP・フォルダ・GitHub でアップロードした直後に、ファイルがこのようなアプリ構成だとはっきり分かると、設定は自動でオンになりエディターが知らせます。自分で確認するなら、左側の設定 ▸ サイト設定 ▸ サイトで[詳細]を開き、「存在しないURLでもメインページを開く(アプリ型サイト向け)」をオンにします。変更は自動で保存され、公開し直さなくてもすぐ反映されます。

    エディターのサイト設定のサイトタブ — サイトの言語とテーマカラー、存在しないURLで表示するページの選択、[詳細]を開くと出るアプリのインストールと「存在しないURLでもメインページを開く」のスイッチ
    サイト設定 ▸ サイト ▸ [詳細]の中に SPA のスイッチがあります
  3. 3

    直リンクとリロードで確かめる

    自分のアドレスの後ろにアプリのパスを付けて開き、リロードしてみてください。404 ではなくアプリの画面が出れば完了です。メインページが開くのは画面用のURL(拡張子のないURL)だけで、画像やスクリプトのように拡張子のあるファイルが存在しないときは、そのまま 404 になります。

    myname.html2site.com/about 公開中

    スイッチをオンにすると、このURLをリロードしてもアプリが開きます

  4. 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 になるのが正しい動作です。アプリが読み込むファイルのパスが合っているか確かめてください。

読むより試すほうが速いです — 手持ちのHTMLを貼り付けて、そのまま公開してみましょう。

現在のワークスペースのサイトを探します。ほかのワークスペースはサイドバー上部で切り替えてください。