본문 바로가기

이 기기의 Yave 통합 계정 로그인이 끝나서, 이 기기에서 쓰던 다른 Yave 서비스도 함께 로그아웃돼요.

SPA 새로고침하면 404가 뜰 때: 설정 한 번으로 해결

마지막 업데이트: 2026-11-11

목차 · 6
  1. 1. 빌드 결과 폴더를 올리세요
  2. 2. SPA 설정이 켜졌는지 확인하세요
  3. 3. 직접 링크와 새로고침으로 확인하세요
  4. 4. 404 페이지와 함께 쓸 때는 하나만 고르세요
  5. 자주 묻는 질문
  6. 이어서 읽어 보세요

결론부터 — 사이트 설정 ▸ 사이트의 [자세히]에서 ‘없는 주소도 메인 페이지로 열기’를 켜면 React·Vue 사이트의 직접 링크와 새로고침이 404 대신 앱으로 열려요. 다만 이 설정을 켜면 ‘없는 주소로 올 때 보여줄 페이지’는 일반 주소에서 쓰이지 않으니, 사이트에 맞는 쪽 하나만 쓰세요.

한눈에 보기

걸리는 시간
약 2분
필요한 요금제
무료로 가능
코드 지식
없어도 돼요
하는 곳
편집기

따라 하기

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

    SPA 설정이 켜졌는지 확인하세요

    ZIP · 폴더 · GitHub로 올린 직후 파일이 이런 앱 구조로 보이면 설정이 자동으로 켜지고, 편집기 첫 화면이 알려줘요. 직접 확인하려면 왼쪽 설정 ▸ 사이트 설정 ▸ 사이트에서 [자세히]를 펼치고 ‘없는 주소도 메인 페이지로 열기 (앱처럼 만든 사이트용)’ 토글을 켜세요. 고치면 저절로 저장되고, 발행을 다시 하지 않아도 바로 적용돼요.

    편집기 사이트 설정의 사이트 탭 — 사이트 언어와 테마 색, 없는 주소로 올 때 보여줄 페이지 선택, 그리고 [자세히]를 펼치면 나오는 앱 설치와 ‘없는 주소도 메인 페이지로 열기’ 토글
    사이트 설정 ▸ 사이트 ▸ [자세히] 안에 SPA 토글이 있어요
  3. 3

    직접 링크와 새로고침으로 확인하세요

    내 주소 뒤에 앱의 경로를 붙여 열고 새로고침해 보세요. 404 대신 앱 화면이 뜨면 끝이에요. 화면 주소(확장자 없는 주소)만 메인 페이지로 열리고, 이미지나 스크립트처럼 확장자가 있는 파일이 없으면 그대로 404예요.

    myname.html2site.com/about 발행됨

    토글을 켜면 이 주소를 새로고침해도 앱이 열려요

  4. 4

    404 페이지와 함께 쓸 때는 하나만 고르세요

    ‘없는 주소로 올 때 보여줄 페이지’는 사이트 설정 ▸ 사이트에서 이 사이트의 페이지 중 골라요(비우면 기본 404 페이지). 페이지가 여러 장인 일반 사이트는 이쪽이 맞고 SPA 토글은 꺼 두세요. 토글을 켜면 없는 주소도 메인 페이지로 열려서 404 페이지가 쓰이지 않아요. 앱 안에서 ‘없는 페이지’ 화면을 보여 주고 싶다면 앱의 라우터에 직접 만들어 주세요.

    사이트 설정 ▸ 사이트
    없는 주소로 올 때 보여줄 페이지 기본 404 페이지
    없는 주소도 메인 페이지로 열기 ON

자주 묻는 질문

React 앱을 새로고침하면 404가 뜨는 이유가 뭔가요?

SPA는 주소마다 파일이 있는 게 아니라, 브라우저 안의 스크립트가 주소를 보고 화면을 그려요. 정적 호스팅은 주소와 같은 이름의 파일을 찾는데 /about에는 파일이 없으니 404가 돼요. 없는 주소도 메인 페이지로 열기를 켜면 그 주소에도 메인 페이지를 내보내서 앱이 이어받아요.

SPA 설정을 직접 켜야 하나요?

ZIP · 폴더 · GitHub로 올린 직후 파일이 앱 구조(빈 메인 페이지에 스크립트가 화면을 그리는 구조 등)로 확실히 보이면 자동으로 켜져요. 확신이 덜한 경우에는 사이트 설정의 [자세히]에 이유와 함께 켜기 제안이 떠요. 어느 쪽이든 토글에서 직접 끄고 켤 수 있어요.

일반 사이트에도 켜 두면 안 되나요?

권하지 않아요. 켜면 오타 주소도 모두 메인 페이지로 열려서 ‘없는 주소로 올 때 보여줄 페이지’가 쓰이지 않고, 검색엔진도 없는 주소를 정상 페이지로 볼 수 있어요. 페이지마다 파일이 있는 사이트는 꺼 두는 게 맞아요.

SPA를 켠 사이트에서 ‘페이지를 찾을 수 없어요’ 화면을 보여 줄 수 있나요?

이 설정은 없는 주소를 메인 페이지로 열어 주는 설정이라, 그 화면은 앱의 라우터가 직접 만들어 보여 줘야 해요. 반대로 404 페이지를 쓰고 싶은 사이트는 토글을 끄고 ‘없는 주소로 올 때 보여줄 페이지’를 고르세요.

켰는데도 404가 뜨면 어떻게 하나요?

먼저 파일 목록에 메인 페이지(index.html)가 있는지 보세요. 메인 페이지가 없으면 열어 줄 화면이 없어서 404가 돼요. 또 .js · .png처럼 확장자가 있는 주소는 파일이 없으면 404가 정상이에요. 앱이 불러오는 파일 경로가 맞는지 확인해 보세요.

읽는 것보다 해 보는 게 빨라요 — 가진 HTML을 붙여 넣고 바로 발행해 보세요.

지금 워크스페이스의 사이트를 찾아요. 다른 워크스페이스는 사이드바 맨 위에서 바꿔 주세요.