Choorai

🛠️ 트러블슈팅

에러 메시지나 증상을 검색해서 해결책을 찾아보세요

자주 발생하는 문제

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

원하는 해결책을 못 찾으셨나요?

AI 프롬프트 레시피를 사용해서 ChatGPT나 Claude에게 직접 물어보세요

AI 프롬프트 레시피

마지막 업데이트: 2026년 2월 22일 · 버전: v0.0.1

피드백 보내기

입력한 내용으로 새 이슈 페이지를 엽니다.

GitHub 이슈로 보내기