SPA 새로고침하면 404가 뜰 때: 설정 한 번으로 해결
마지막 업데이트: 2026-11-11
결론부터 — 사이트 설정 ▸ 사이트의 [자세히]에서 ‘없는 주소도 메인 페이지로 열기’를 켜면 React·Vue 사이트의 직접 링크와 새로고침이 404 대신 앱으로 열려요. 다만 이 설정을 켜면 ‘없는 주소로 올 때 보여줄 페이지’는 일반 주소에서 쓰이지 않으니, 사이트에 맞는 쪽 하나만 쓰세요.
한눈에 보기
- 걸리는 시간
- 약 2분
- 필요한 요금제
- 무료로 가능
- 코드 지식
- 없어도 돼요
- 하는 곳
- 편집기
따라 하기
- 1
빌드 결과 폴더를 올리세요
React·Vue·Vite 사이트는 빌드 명령으로 나온 결과 폴더(보통 dist)를 ZIP으로 묶거나 폴더째 올려요. 이런 사이트는 index.html이 거의 빈 껍데기이고 스크립트가 화면을 그려요. 그래서 /about 같은 주소에는 파일이 없고, 설정이 꺼져 있으면 그 주소를 직접 열거나 새로고침할 때 404가 떠요.
index.html<!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script> - 2
SPA 설정이 켜졌는지 확인하세요
ZIP · 폴더 · GitHub로 올린 직후 파일이 이런 앱 구조로 보이면 설정이 자동으로 켜지고, 편집기 첫 화면이 알려줘요. 직접 확인하려면 왼쪽 설정 ▸ 사이트 설정 ▸ 사이트에서 [자세히]를 펼치고 ‘없는 주소도 메인 페이지로 열기 (앱처럼 만든 사이트용)’ 토글을 켜세요. 고치면 저절로 저장되고, 발행을 다시 하지 않아도 바로 적용돼요.
사이트 설정 ▸ 사이트 ▸ [자세히] 안에 SPA 토글이 있어요 - 3
직접 링크와 새로고침으로 확인하세요
내 주소 뒤에 앱의 경로를 붙여 열고 새로고침해 보세요. 404 대신 앱 화면이 뜨면 끝이에요. 화면 주소(확장자 없는 주소)만 메인 페이지로 열리고, 이미지나 스크립트처럼 확장자가 있는 파일이 없으면 그대로 404예요.
myname.html2site.com/about 발행됨토글을 켜면 이 주소를 새로고침해도 앱이 열려요
- 4
404 페이지와 함께 쓸 때는 하나만 고르세요
‘없는 주소로 올 때 보여줄 페이지’는 사이트 설정 ▸ 사이트에서 이 사이트의 페이지 중 골라요(비우면 기본 404 페이지). 페이지가 여러 장인 일반 사이트는 이쪽이 맞고 SPA 토글은 꺼 두세요. 토글을 켜면 없는 주소도 메인 페이지로 열려서 404 페이지가 쓰이지 않아요. 앱 안에서 ‘없는 페이지’ 화면을 보여 주고 싶다면 앱의 라우터에 직접 만들어 주세요.
사이트 설정 ▸ 사이트없는 주소로 올 때 보여줄 페이지 기본 404 페이지없는 주소도 메인 페이지로 열기 ON
자주 묻는 질문
React 앱을 새로고침하면 404가 뜨는 이유가 뭔가요?
SPA는 주소마다 파일이 있는 게 아니라, 브라우저 안의 스크립트가 주소를 보고 화면을 그려요. 정적 호스팅은 주소와 같은 이름의 파일을 찾는데 /about에는 파일이 없으니 404가 돼요. 없는 주소도 메인 페이지로 열기를 켜면 그 주소에도 메인 페이지를 내보내서 앱이 이어받아요.
SPA 설정을 직접 켜야 하나요?
ZIP · 폴더 · GitHub로 올린 직후 파일이 앱 구조(빈 메인 페이지에 스크립트가 화면을 그리는 구조 등)로 확실히 보이면 자동으로 켜져요. 확신이 덜한 경우에는 사이트 설정의 [자세히]에 이유와 함께 켜기 제안이 떠요. 어느 쪽이든 토글에서 직접 끄고 켤 수 있어요.
일반 사이트에도 켜 두면 안 되나요?
권하지 않아요. 켜면 오타 주소도 모두 메인 페이지로 열려서 ‘없는 주소로 올 때 보여줄 페이지’가 쓰이지 않고, 검색엔진도 없는 주소를 정상 페이지로 볼 수 있어요. 페이지마다 파일이 있는 사이트는 꺼 두는 게 맞아요.
SPA를 켠 사이트에서 ‘페이지를 찾을 수 없어요’ 화면을 보여 줄 수 있나요?
이 설정은 없는 주소를 메인 페이지로 열어 주는 설정이라, 그 화면은 앱의 라우터가 직접 만들어 보여 줘야 해요. 반대로 404 페이지를 쓰고 싶은 사이트는 토글을 끄고 ‘없는 주소로 올 때 보여줄 페이지’를 고르세요.
켰는데도 404가 뜨면 어떻게 하나요?
먼저 파일 목록에 메인 페이지(index.html)가 있는지 보세요. 메인 페이지가 없으면 열어 줄 화면이 없어서 404가 돼요. 또 .js · .png처럼 확장자가 있는 주소는 파일이 없으면 404가 정상이에요. 앱이 불러오는 파일 경로가 맞는지 확인해 보세요.
이어서 읽어 보세요
- 사이트 폴더를 ZIP으로 올려 내 주소 만들기 CSS·JS·이미지·하위 페이지가 있는 사이트를 ZIP 또는 폴더째 올려 무료로 내 주소에 발행하는 가이드(한국어)
- GitHub 저장소를 가져와 정적 사이트로 배포하는 법 공개 GitHub 저장소의 정적 파일을 가져와 무료로 내 주소에 발행하는 가이드 — 빌드 없음, index.html 필요(한국어)
- 발행한 사이트, 이전 버전으로 되돌리는 법 발행한 사이트를 이전 버전으로 되돌리는 방법 — 버전 확인, 되돌리기, 되돌리기 취소, 무료와 Plus의 보관 범위(한국어)
- 내 도메인을 사이트에 연결하는 법 발행한 HTML 사이트에 내가 산 도메인을 연결하는 단계별 가이드(주소 입력 · CNAME과 TXT 값 추가 · 연결 확인 · HTTPS 자동, Plus부터)
읽는 것보다 해 보는 게 빨라요 — 가진 HTML을 붙여 넣고 바로 발행해 보세요.