Aller au contenu

Cela met fin à la connexion de votre compte Yave sur cet appareil : les autres services Yave que vous y utilisez seront aussi déconnectés.

Votre SPA affiche 404 au rechargement ? Un réglage suffit

Dernière mise à jour: 2026-11-11

Sommaire · 6
  1. 1. Importez le dossier issu du build
  2. 2. Vérifiez que l’option SPA est activée
  3. 3. Testez avec un lien direct et un rechargement
  4. 4. Une page 404 en plus ? N’en gardez qu’une
  5. Questions fréquentes
  6. À lire ensuite

En bref : dans Paramètres du site > Site, ouvrez Plus et activez « Ouvrir la page principale pour les adresses inconnues (sites de type appli) » ; les liens directs et les rechargements d’un site React ou Vue ouvrent alors votre app au lieu d’un 404. Attention : une fois l’option activée, la « Page affichée pour les adresses inexistantes » n’est plus utilisée pour les adresses ordinaires, choisissez donc celle qui convient à votre site.

En bref

Temps nécessaire
Environ 2 min
Forfait requis
Gratuit
Connaissances en code
Aucune
Où le faire
Éditeur

Pas à pas

  1. 1

    Importez le dossier issu du build

    Pour un site React, Vue ou Vite, importez le dossier produit par votre commande de build (souvent dist), en ZIP ou tel quel. Ces sites contiennent un index.html presque vide et un script dessine l’écran. Il n’existe donc aucun fichier pour une adresse comme /about, et avec l’option désactivée, ouvrir cette adresse directement ou la recharger donne un 404.

    index.html
    <!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script>
  2. 2

    Vérifiez que l’option SPA est activée

    Juste après un import par ZIP, dossier ou GitHub, si vos fichiers ont clairement cette structure d’application, l’option s’active toute seule et l’éditeur vous le signale. Pour vérifier vous-même, allez dans Réglages > Paramètres du site > Site dans le menu de gauche, ouvrez Plus et activez « Ouvrir la page principale pour les adresses inconnues (sites de type appli) ». Les modifications s’enregistrent automatiquement et s’appliquent tout de suite, sans republier.

    Onglet Site des Paramètres du site dans l’éditeur : langue du site, couleur du thème, page pour les adresses inexistantes et, avec Plus déplié, l’installation de l’app et le bouton pour ouvrir la page principale sur les adresses inconnues
    Paramètres du site > Site > Plus contient le bouton SPA
  3. 3

    Testez avec un lien direct et un rechargement

    Ouvrez votre adresse suivie d’une route de votre app, puis rechargez. Si votre app s’affiche au lieu d’un 404, c’est gagné. Seules les adresses d’écran (sans extension) ouvrent la page principale ; un fichier absent avec extension, comme une image ou un script, renvoie toujours un 404.

    myname.html2site.com/about En ligne

    Une fois le bouton activé, recharger cette adresse ouvre votre app

  4. 4

    Une page 404 en plus ? N’en gardez qu’une

    La « Page affichée pour les adresses inexistantes » se choisit dans Paramètres du site > Site parmi les pages de ce site (sans choix, la page 404 par défaut s’affiche). C’est le bon choix pour un site classique à plusieurs pages, avec le bouton SPA désactivé. Avec le bouton activé, les adresses inconnues ouvrent la page principale et cette page 404 n’est pas utilisée. Pour un écran « introuvable » dans une app, créez-le dans le routeur de votre app.

    Paramètres du site > Site
    Page affichée pour les adresses inexistantes Page 404 par défaut
    Ouvrir la page principale pour les adresses inconnues ON

Questions fréquentes

Pourquoi mon app React affiche-t-elle 404 au rechargement ?

Une application monopage n’a pas un fichier par adresse : un script dans le navigateur lit l’adresse et dessine l’écran. L’hébergement statique cherche un fichier du même nom que l’adresse, n’en trouve pas pour /about et renvoie 404. Avec l’option SPA, cette adresse sert la page principale et votre app prend le relais.

Dois-je activer moi-même l’option SPA ?

Juste après un import par ZIP, dossier ou GitHub, elle s’active seule quand vos fichiers ont clairement la forme d’une app (par exemple une page principale vide qu’un script remplit). Quand les indices sont plus faibles, les Paramètres du site affichent une suggestion avec la raison sous Plus. Dans les deux cas, vous pouvez l’activer ou la désactiver avec le bouton.

Puis-je la laisser activée pour un site classique ?

Ce n’est pas recommandé. Activée, toute adresse mal saisie ouvre la page principale, votre page 404 personnalisée n’est jamais utilisée et les moteurs de recherche peuvent traiter des adresses inexistantes comme de vraies pages. Les sites avec un fichier par page doivent la laisser désactivée.

Puis-je quand même afficher un écran « page introuvable » sur un site SPA ?

Cette option envoie les adresses inconnues vers la page principale, cet écran doit donc venir du routeur de votre propre app. Si vous préférez une page 404, désactivez le bouton et choisissez une page dans « Page affichée pour les adresses inexistantes ».

Je l’ai activée et j’ai toujours un 404. Que faire ?

Vérifiez d’abord que la liste des fichiers contient une page principale (index.html) ; sans elle, il n’y a rien à ouvrir et vous obtenez un 404. Par ailleurs, les adresses avec extension, comme .js ou .png, renvoient normalement un 404 si le fichier est absent ; vérifiez que les chemins chargés par votre app sont corrects.

Essayer est plus rapide que lire — collez votre HTML et publiez-le tout de suite.

Recherche dans l'espace de travail actuel. Pour changer d'espace de travail, utilisez le haut de la barre latérale.