Vite
Vite는 프론트엔드 개발 서버와 프로덕션 번들을 제공하는 빌드 도구입니다.
정상 동작 조건
요약
Vite 문제를 확인할 때는 개발 서버와 vite build 결과를 분리하고, 현재 작업 디렉터리·기본 경로·환경 변수 접두사를 함께 확인해야 합니다.
확인 절차
Vite는 개발 서버와 프로덕션 번들을 별도 명령으로 제공합니다. 개발 서버에서 동작한 결과만으로 배포 산출물의 경로, 정적 자산 주소와 환경 변수 값이 올바르다고 판단하지 않습니다.
배포 전 확인
- 실제 실행한 명령과 현재 작업 디렉터리를 기록합니다.
vite build결과 디렉터리와 배포 서비스의 산출물 경로를 비교합니다.- 브라우저에 노출되어도 되는 값과 서버 전용 비밀값을 분리합니다.
- 하위 경로에 배포한다면
base설정과 실제 요청 주소를 함께 확인합니다.
배포 후에만 발생하는 오류는 빌드 산출물 (새 창에서 열림)과 환경 변수 (새 창에서 열림)의 적용 범위를 분리해 확인합니다.
관련 오류
참고 자료
Vite Guide (새 창에서 열림)
Vite · 공식 자료 · 확인 범위: dev-server, production-build, build-configuration · 확인일: 2026-07-27