La tua SPA dà 404 al ricaricamento? Si risolve con un’impostazione
Ultimo aggiornamento: 2026-11-11
In breve: in Impostazioni sito > Sito apri Altro e attiva «Apri la pagina principale per indirizzi sconosciuti (siti tipo app)»; così link diretti e ricaricamenti di un sito React o Vue aprono la tua app invece di un 404. Attenzione: con l’opzione attiva, la «Pagina da mostrare per indirizzi inesistenti» non viene usata per gli indirizzi normali, quindi scegli quella adatta al tuo sito.
In breve
- Tempo necessario
- Circa 2 min
- Piano richiesto
- Gratis
- Conoscenze di codice
- Nessuna
- Dove si fa
- Editor
Passo passo
- 1
Carica la cartella con il risultato della build
Per un sito React, Vue o Vite, carica la cartella prodotta dal comando di build (di solito dist), in ZIP o come cartella. Questi siti hanno un index.html quasi vuoto e uno script disegna la schermata. Per questo non esiste un file per un indirizzo come /about, e con l’opzione disattivata aprire direttamente quell’indirizzo o ricaricarlo dà 404.
index.html<!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script> - 2
Controlla che l’opzione SPA sia attiva
Subito dopo un’importazione da ZIP, cartella o GitHub, se i file hanno chiaramente questa struttura da app, l’opzione si attiva da sola e l’editor te lo segnala. Per controllare di persona, vai su Opzioni > Impostazioni sito > Sito nel menu a sinistra, apri Altro e attiva «Apri la pagina principale per indirizzi sconosciuti (siti tipo app)». Le modifiche si salvano da sole e valgono subito, senza ripubblicare.
Impostazioni sito > Sito > Altro contiene l’interruttore SPA - 3
Prova con un link diretto e un ricaricamento
Apri il tuo indirizzo seguito da un percorso della tua app e ricarica. Se compare la tua app invece di un 404, hai finito. Solo gli indirizzi di schermata (senza estensione) aprono la pagina principale; un file inesistente con estensione, come un’immagine o uno script, dà comunque 404.
myname.html2site.com/about OnlineCon l’interruttore attivo, ricaricare questo indirizzo apre la tua app
- 4
Usi anche una pagina 404? Scegline una
La «Pagina da mostrare per indirizzi inesistenti» si sceglie in Impostazioni sito > Sito tra le pagine di questo sito (se non scegli nulla, appare la pagina 404 predefinita). È la scelta giusta per i siti normali con più pagine, con l’interruttore SPA disattivato. Con l’interruttore attivo, gli indirizzi sconosciuti aprono la pagina principale e quella pagina 404 non viene usata. Se vuoi una schermata «non trovato» dentro un’app, creala nel router della tua app.
Impostazioni sito > SitoPagina da mostrare per indirizzi inesistenti Pagina 404 predefinitaApri la pagina principale per indirizzi sconosciuti ON
Domande frequenti
Perché la mia app React dà 404 al ricaricamento?
Un’app a pagina singola non ha un file per ogni indirizzo: uno script nel browser legge l’indirizzo e disegna la schermata. L’hosting statico cerca un file con lo stesso nome dell’indirizzo, per /about non lo trova e risponde 404. Attivando l’opzione SPA, quell’indirizzo serve la pagina principale e la tua app subentra.
Devo attivare io l’opzione SPA?
Subito dopo un’importazione da ZIP, cartella o GitHub si attiva da sola quando i file hanno chiaramente la forma di un’app (per esempio una pagina principale vuota che uno script riempie). Quando gli indizi sono più deboli, Impostazioni sito mostra un suggerimento con il motivo sotto Altro. In entrambi i casi puoi attivarla o disattivarla con l’interruttore.
Posso lasciarla attiva su un sito normale?
Non è consigliato. Con l’opzione attiva, ogni indirizzo digitato male apre la pagina principale, la tua pagina 404 personalizzata non viene mai usata e i motori di ricerca possono trattare indirizzi inesistenti come pagine vere. I siti con un file per pagina devono lasciarla disattivata.
Posso comunque mostrare una schermata «pagina non trovata» su un sito SPA?
Questa opzione manda gli indirizzi sconosciuti alla pagina principale, quindi quella schermata deve venire dal router della tua app. Se preferisci una pagina 404, disattiva l’interruttore e scegli una pagina in «Pagina da mostrare per indirizzi inesistenti».
L’ho attivata ma esce ancora 404. Che fare?
Controlla prima che l’elenco dei file contenga una pagina principale (index.html); senza, non c’è nulla da aprire e si ottiene 404. Inoltre gli indirizzi con estensione, come .js o .png, restituiscono giustamente 404 se il file manca; verifica che i percorsi caricati dalla tua app siano corretti.
Leggi anche
- Carica la cartella del tuo sito come ZIP e ottieni un indirizzo tutto tuo Guida per pubblicare gratis al tuo indirizzo un sito con più file (CSS, JS, immagini, altre pagine) da uno ZIP o da un'intera cartella (italiano)
- Importa un repository GitHub e pubblicalo come sito statico Guida per importare i file statici di un repository GitHub pubblico e pubblicarli gratis al tuo indirizzo: senza build, index.html obbligatorio (italiano)
- Come tornare a una versione precedente del tuo sito pubblicato Come tornare a una versione precedente di un sito pubblicato: controllare, ripristinare, annullare il ripristino e cosa conservano Gratis e Plus (italiano)
- Come collegare il tuo dominio al tuo sito Guida passo passo per collegare il tuo dominio a un sito HTML pubblicato: inserire l’indirizzo, aggiungere i valori CNAME e TXT dove hai comprato il dominio, attendere Collegato, HTTPS automatico (dal piano Plus)
Provare è più veloce che leggere: incolla il tuo HTML e pubblicalo subito.