Vercel 배포는 됐는데 새로고침만 404라면, SPA rewrite를 확인하세요
React SPA를 Vercel에 배포한 뒤 링크 이동은 되지만 하위 경로 새로고침만 404가 될 때, 앱 종류를 가르고 rewrite를 적용해 검증하는 순서다.
AI로 만든 코드가 실제로 동작하게 만드는 점검 노트
TOPIC
Vercel, 빌드, 런타임
React SPA를 Vercel에 배포한 뒤 링크 이동은 되지만 하위 경로 새로고침만 404가 될 때, 앱 종류를 가르고 rewrite를 적용해 검증하는 순서다.
Vercel 배포 뒤 504 FUNCTION_INVOCATION_TIMEOUT이 뜰 때 런타임 로그와 구간별 시간 측정으로 느린 외부 호출, 응답 누락, 반복문을 구분하는 점검 순서입니다.
Vercel 배포가 성공으로 끝났는데 공개 URL에서 404가 뜰 때 기본 URL, 하위 경로, 프레임워크, Root·Output Directory, rewrite와 도메인을 순서대로 점검하는 방법입니다.
Vercel에서 배포 성공을 봤는데 공개 도메인에는 예전 화면이 남아 있다면 코드를 다시 고치기 전에 Git commit, Deployment, Production 도메인, 깨끗한 브라우저 화면을 순서대로 연결해 보세요.
Vercel 배포 로그에 No Output Directory named dist가 나오면 폴더를 억지로 만들기보다, 로컬 빌드 결과·Framework Preset·Root Directory·Output Directory가 서로 맞는지 순서대로 확인해야 합니다.
로컬에서는 통과하는데 Vercel 배포에서만 Module not found가 뜰 때, npm 재설치 전에 파일명 대소문자와 Git 추적 상태를 3분 안에 확인하는 순서입니다.
GitHub Actions가 빨갛게 실패했을 때 전체 로그를 AI에게 붙여 넣기 전에 job, step, 실행 명령, 첫 에러 줄, 비밀값 경계를 3분 안에 나누는 초보자용 체크리스트입니다.
AI가 만든 React/Vite 앱을 Vercel에 올린 뒤 홈은 열리는데 /dashboard 같은 하위 주소를 새로고침할 때만 404가 난다면, 라우터 전체를 갈아엎기 전에 SPA rewrites와 React Router preset을 3분 순서로 확인해야 합니다.