¿Tu SPA da 404 al recargar? Se arregla con un ajuste
Última actualización: 2026-11-11
En corto: en Ajustes del sitio > Sitio, abre Más y activa «Abrir la página principal en direcciones desconocidas (sitios tipo app)»; así los enlaces directos y las recargas de un sitio React o Vue abren tu app en vez de un 404. Ojo: con esa opción activada, la «Página que se muestra en direcciones inexistentes» no se usa en las direcciones normales, así que elige la que encaje con tu sitio.
De un vistazo
- Tiempo necesario
- Unos 2 min
- Plan necesario
- Gratis
- Conocimientos de código
- Ninguno
- Dónde se hace
- Editor
Paso a paso
- 1
Sube la carpeta con el resultado del build
En un sitio React, Vue o Vite, sube la carpeta que genera tu comando de build (normalmente dist), en ZIP o como carpeta. Estos sitios traen un index.html casi vacío y un script dibuja la pantalla. Por eso no hay ningún archivo para una dirección como /about, y con la opción desactivada, abrir esa dirección directamente o recargarla da un 404.
index.html<!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script> - 2
Comprueba que la opción SPA está activada
Justo después de importar por ZIP, carpeta o GitHub, si tus archivos tienen claramente esa estructura de app, la opción se activa sola y el editor te avisa. Para comprobarlo tú, ve a Ajustes > Ajustes del sitio > Sitio en el panel izquierdo, abre Más y activa «Abrir la página principal en direcciones desconocidas (sitios tipo app)». Los cambios se guardan solos y se aplican al momento, sin volver a publicar.
Ajustes del sitio > Sitio > Más contiene el interruptor SPA - 3
Pruébalo con un enlace directo y una recarga
Abre tu dirección con una ruta de tu app al final y recarga. Si aparece tu app en vez de un 404, listo. Solo las direcciones de pantalla (sin extensión) abren la página principal; un archivo inexistente con extensión, como una imagen o un script, sigue dando 404.
myname.html2site.com/about PublicadoCon el interruptor activado, recargar esta dirección abre tu app
- 4
¿Usas también una página 404? Elige una
La «Página que se muestra en direcciones inexistentes» se elige en Ajustes del sitio > Sitio entre las páginas de este sitio (si no eliges ninguna, sale la página 404 predeterminada). Es lo correcto en sitios normales de varias páginas, con el interruptor SPA desactivado. Con el interruptor activado, las direcciones desconocidas abren la página principal y esa página 404 no se usa. Si quieres una pantalla de «no encontrado» dentro de una app, créala en el router de tu app.
Ajustes del sitio > SitioPágina que se muestra en direcciones inexistentes Página 404 predeterminadaAbrir la página principal en direcciones desconocidas ON
Preguntas frecuentes
¿Por qué mi app de React da 404 al recargar?
Una app de una sola página no tiene un archivo por dirección; un script del navegador lee la dirección y dibuja la pantalla. El hosting estático busca un archivo con el mismo nombre que la dirección, no encuentra ninguno para /about y devuelve 404. Al activar la opción SPA, esa dirección sirve tu página principal y tu app toma el control.
¿Tengo que activar la opción SPA yo mismo?
Justo después de importar por ZIP, carpeta o GitHub se activa sola cuando tus archivos tienen claramente forma de app (por ejemplo, una página principal vacía que rellena un script). Si los indicios son más débiles, Ajustes del sitio muestra una sugerencia con el motivo dentro de Más. En ambos casos puedes activarla o desactivarla con el interruptor.
¿Puedo dejarla activada en una web normal?
No es recomendable. Con ella activada, cualquier dirección mal escrita abre la página principal, tu página 404 personalizada nunca se usa y los buscadores pueden tratar direcciones inexistentes como páginas reales. Los sitios con un archivo por página deben dejarla desactivada.
¿Puedo mostrar una pantalla de «página no encontrada» en un sitio SPA?
Esta opción manda las direcciones desconocidas a la página principal, así que esa pantalla debe salir del router de tu propia app. Si prefieres una página 404, desactiva el interruptor y elige una página en «Página que se muestra en direcciones inexistentes».
La activé y sigue saliendo 404. ¿Qué hago?
Primero comprueba que la lista de archivos tiene una página principal (index.html); sin ella no hay nada que abrir y sale 404. Además, las direcciones con extensión, como .js o .png, devuelven 404 si falta el archivo, y eso es lo correcto; revisa que las rutas que carga tu app sean las adecuadas.
Sigue leyendo
- Sube la carpeta de tu sitio como ZIP y consigue tu propia dirección Guía para publicar gratis en tu propia dirección un sitio de varios archivos (CSS, JS, imágenes, más páginas) desde un ZIP o una carpeta entera (español)
- Importa un repositorio de GitHub y despliégalo como sitio estático Guía para importar los archivos estáticos de un repositorio público de GitHub y publicarlos gratis en tu dirección: sin compilación, se necesita index.html (español)
- Cómo volver a una versión anterior de tu sitio publicado Cómo volver a una versión anterior de un sitio publicado: revisar, restaurar, deshacer la restauración y qué conservan Gratis y Plus (español)
- Cómo conectar tu propio dominio a tu sitio Guía paso a paso para conectar tu propio dominio a una web HTML publicada: escribir la dirección, añadir los valores CNAME y TXT donde compraste el dominio, esperar a Conectado, HTTPS automático (desde Plus)
Probarlo es más rápido que leerlo: pega tu HTML y publícalo ahora mismo.