Ir al contenido

Se cerrará tu sesión de la cuenta Yave en este dispositivo, así que también se cerrará la sesión de los demás servicios Yave que usas en él.

¿Tu SPA da 404 al recargar? Se arregla con un ajuste

Última actualización: 2026-11-11

Contenido · 6
  1. 1. Sube la carpeta con el resultado del build
  2. 2. Comprueba que la opción SPA está activada
  3. 3. Pruébalo con un enlace directo y una recarga
  4. 4. ¿Usas también una página 404? Elige una
  5. Preguntas frecuentes
  6. Sigue leyendo

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

    Pestaña Sitio de los Ajustes del sitio en el editor: idioma del sitio, color del tema, la página para direcciones inexistentes y, con Más desplegado, la instalación de app y el interruptor para abrir la página principal en direcciones desconocidas
    Ajustes del sitio > Sitio > Más contiene el interruptor SPA
  3. 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 Publicado

    Con el interruptor activado, recargar esta dirección abre tu app

  4. 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 > Sitio
    Página que se muestra en direcciones inexistentes Página 404 predeterminada
    Abrir 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.

Probarlo es más rápido que leerlo: pega tu HTML y publícalo ahora mismo.

Busca sitios en el espacio de trabajo actual. Para cambiar de espacio de trabajo, usa la parte superior de la barra lateral.