Votre SPA affiche 404 au rechargement ? Un réglage suffit
Dernière mise à jour: 2026-11-11
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
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
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.
Paramètres du site > Site > Plus contient le bouton SPA - 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 ligneUne fois le bouton activé, recharger cette adresse ouvre votre app
- 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 > SitePage affichée pour les adresses inexistantes Page 404 par défautOuvrir 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.
À lire ensuite
- Importer le dossier de votre site en ZIP et obtenir votre propre adresse Guide pour publier gratuitement à votre propre adresse un site de plusieurs fichiers (CSS, JS, images, autres pages) depuis un ZIP ou un dossier entier (français)
- Importer un dépôt GitHub et le déployer en site statique Guide pour importer les fichiers statiques d'un dépôt GitHub public et les publier gratuitement à votre adresse : sans compilation, index.html requis (français)
- Revenir à une version précédente de votre site publié Comment revenir à une version précédente d’un site publié : consulter, restaurer, annuler la restauration et ce que conservent l’offre gratuite et Plus (français)
- Comment connecter votre propre domaine à votre site Guide pas à pas pour connecter votre propre domaine à un site HTML publié : saisir l’adresse, ajouter les valeurs CNAME et TXT chez votre fournisseur, attendre Connecté, HTTPS automatique (dès Plus)
Essayer est plus rapide que lire — collez votre HTML et publiez-le tout de suite.