Sua SPA dá 404 ao atualizar? Uma configuração resolve
Última atualização: 2026-11-11
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
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
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.
Configurações do site > Site > Mais tem o botão da SPA - 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 PublicadoCom o botão ligado, atualizar este endereço abre o seu app
- 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 > SitePágina exibida para endereços inexistentes Página 404 padrãoAbrir 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.
Leia também
- Envie a pasta do seu site como ZIP e ganhe um endereço próprio Guia para publicar de graça no seu endereço um site com vários arquivos (CSS, JS, imagens, outras páginas) a partir de um ZIP ou de uma pasta inteira (português)
- Importe um repositório do GitHub e publique como site estático Guia para importar os arquivos estáticos de um repositório público do GitHub e publicá-los de graça no seu endereço: sem build, index.html obrigatório (português)
- Como voltar a uma versão anterior do seu site publicado Como voltar a uma versão anterior de um site publicado: revisar, restaurar, desfazer a restauração e o que o plano grátis e o Plus guardam (português)
- Como conectar seu próprio domínio ao seu site Guia passo a passo para conectar seu próprio domínio a um site HTML publicado: digitar o endereço, adicionar os valores CNAME e TXT onde comprou o domínio, aguardar Conectado, HTTPS automático (a partir do Plus)
Testar é mais rápido que ler — cole seu HTML e publique agora.