Pular para o conteúdo

Isso encerra o login da sua conta Yave neste dispositivo, então os outros serviços Yave que você usa nele também serão desconectados.

Sua SPA dá 404 ao atualizar? Uma configuração resolve

Última atualização: 2026-11-11

Conteúdo · 6
  1. 1. Envie a pasta com o resultado do build
  2. 2. Confira se a opção SPA está ligada
  3. 3. Teste com um link direto e uma atualização
  4. 4. Usa também uma página 404? Escolha uma
  5. Perguntas frequentes
  6. Leia também

Resumindo: em Configurações do site > Site, abra Mais e ligue «Abrir a página principal em endereços desconhecidos (sites tipo app)»; assim links diretos e atualizações de um site React ou Vue abrem o seu app em vez de um 404. Atenção: com isso ligado, a «Página exibida para endereços inexistentes» não é usada em endereços comuns, então escolha a que combina com o seu site.

Resumo rápido

Tempo necessário
Cerca de 2 min
Plano necessário
Grátis
Conhecimento de código
Nenhum
Onde fazer
Editor

Passo a passo

  1. 1

    Envie a pasta com o resultado do build

    Num site React, Vue ou Vite, envie a pasta gerada pelo comando de build (normalmente dist), em ZIP ou como pasta. Esses sites trazem um index.html quase vazio e um script desenha a tela. Por isso não existe arquivo para um endereço como /about, e com a opção desligada, abrir esse endereço direto ou atualizá-lo dá 404.

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

    Confira se a opção SPA está ligada

    Logo depois de importar por ZIP, pasta ou GitHub, se os arquivos tiverem claramente essa estrutura de app, a opção liga sozinha e o editor avisa. Para conferir por conta própria, vá em Ajustes > Configurações do site > Site no menu da esquerda, abra Mais e ligue «Abrir a página principal em endereços desconhecidos (sites tipo app)». As alterações são salvas sozinhas e valem na hora, sem publicar de novo.

    Aba Site das Configurações do site no editor: idioma do site, cor do tema, a página para endereços inexistentes e, com Mais aberto, a instalação do app e o botão para abrir a página principal em endereços desconhecidos
    Configurações do site > Site > Mais tem o botão da SPA
  3. 3

    Teste com um link direto e uma atualização

    Abra seu endereço com uma rota do seu app no final e atualize a página. Se o app aparecer em vez de um 404, pronto. Só endereços de tela (sem extensão) abrem a página principal; um arquivo inexistente com extensão, como imagem ou script, continua dando 404.

    myname.html2site.com/about Publicado

    Com o botão ligado, atualizar este endereço abre o seu app

  4. 4

    Usa também uma página 404? Escolha uma

    A «Página exibida para endereços inexistentes» é escolhida em Configurações do site > Site entre as páginas deste site (sem escolha, aparece a página 404 padrão). É o certo para sites comuns de várias páginas, com o botão da SPA desligado. Com o botão ligado, endereços desconhecidos abrem a página principal e essa página 404 não é usada. Se quiser uma tela de «não encontrado» dentro de um app, crie-a no roteador do app.

    Configurações do site > Site
    Página exibida para endereços inexistentes Página 404 padrão
    Abrir a página principal em endereços desconhecidos ON

Perguntas frequentes

Por que meu app React dá 404 ao atualizar?

Um app de página única não tem um arquivo por endereço; um script no navegador lê o endereço e desenha a tela. A hospedagem estática procura um arquivo com o mesmo nome do endereço, não acha nenhum para /about e devolve 404. Ligando a opção SPA, esse endereço passa a servir a página principal e o seu app assume.

Preciso ligar a opção SPA por conta própria?

Logo após importar por ZIP, pasta ou GitHub, ela liga sozinha quando os arquivos têm claramente forma de app (por exemplo, uma página principal vazia que um script preenche). Quando os sinais são mais fracos, as Configurações do site mostram uma sugestão com o motivo em Mais. Nos dois casos você pode ligar ou desligar pelo botão.

Posso deixar ligada num site comum?

Não é recomendado. Ligada, qualquer endereço digitado errado abre a página principal, sua página 404 personalizada nunca é usada e os buscadores podem tratar endereços inexistentes como páginas reais. Sites com um arquivo por página devem deixá-la desligada.

Ainda posso mostrar uma tela de «página não encontrada» num site SPA?

Esta opção manda endereços desconhecidos para a página principal, então essa tela precisa vir do roteador do seu próprio app. Se preferir uma página 404, desligue o botão e escolha uma página em «Página exibida para endereços inexistentes».

Liguei e ainda dá 404. O que fazer?

Primeiro veja se a lista de arquivos tem uma página principal (index.html); sem ela não há o que abrir e dá 404. Além disso, endereços com extensão, como .js ou .png, devolvem 404 quando o arquivo não existe, e isso é o esperado; confira se os caminhos que o seu app carrega estão certos.

Testar é mais rápido que ler — cole seu HTML e publique agora.

Busca sites no espaço de trabalho atual. Para trocar de espaço de trabalho, use o topo da barra lateral.