🛠️ 트러블슈팅
에러 메시지나 증상을 검색해서 해결책을 찾아보세요
자주 발생하는 문제
CORS 에러
자주 발생백엔드 API 호출 시 "has been blocked by CORS policy" 에러
배포 CORS blocked cross-origin
SPA 404 에러
자주 발생새로고침하면 404 Not Found가 뜨는 문제
배포 404 refresh route
환경변수 문제
process.env 또는 import.meta.env가 undefined인 문제
환경변수 env undefined environment
인증 쿠키 문제
로그인은 되는데 쿠키가 저장되지 않는 문제
인증 cookie session login
빌드 실패
npm run build 또는 docker build가 실패하는 문제
빌드 build fail error
DNS NXDOMAIN
자주 발생도메인 접속 시 DNS_PROBE_FINISHED_NXDOMAIN가 뜨는 문제
도메인 NXDOMAIN DNS 도메인
SSL 인증서 오류
자주 발생ERR_CERT_COMMON_NAME_INVALID, 인증서 경고 문제
보안 SSL TLS certificate
Failed to fetch
브라우저에서 TypeError: Failed to fetch가 발생하는 문제
네트워크 fetch network CORS
Node 버전 불일치
로컬과 CI Node 버전 차이로 빌드가 실패하는 문제
빌드 node engine version
429 Rate Limit
API 호출량 제한으로 429 Too Many Requests가 발생하는 문제
네트워크 429 rate limit retry-after
Mixed Content 차단
자주 발생HTTPS 페이지에서 HTTP 리소스 호출이 차단되는 문제
보안 mixed content HTTPS HTTP
502/504 Gateway Timeout
프록시-백엔드 구간 지연으로 502/504가 발생하는 문제
네트워크 502 504 timeout
빌드 OOM
CI 빌드 중 메모리 부족(heap out of memory)이 발생하는 문제
빌드 OOM heap memory
CORS Preflight 405
OPTIONS 사전 요청이 405로 실패하는 문제
네트워크 preflight OPTIONS 405
Webhook 서명 검증 실패
Webhook signature verification failed 오류가 발생하는 문제
보안 webhook signature stripe
마지막 업데이트: 2026년 2월 22일 · 버전: v0.0.1
피드백 보내기
입력한 내용으로 새 이슈 페이지를 엽니다.
GitHub 이슈로 보내기