title: “Nginx에서 404 발생 시 index.html로 리다이렉트하는 방법 (SPA 배포 오류 해결)” date: 2026-02-22 draft: false tags: [“nginx”, “spa”, “troubleshooting”] categories: [“Nginx”] description: “SPA 프로젝트를 nginx에 배포했을 때 직접 경로 접근 시 404가 발생하는 문제 해결 방법”

문제 상황

React 또는 Vue 같은 SPA를 nginx에 배포했을 때
직접 URL 접근 시 404 오류가 발생하는 문제가 있다.

예:

새로고침하면 404 발생.

원인

nginx는 실제 파일이 존재하는 경우만 서빙한다.
SPA는 라우팅을 클라이언트에서 처리하기 때문에 문제가 발생한다.

해결 방법

nginx.conf에서 다음과 같이 설정한다.

location / {
    try_files $uri $uri.html $uri/ /index.html;
}