504서버 오류(5xx)
504 Gateway Timeout — 게이트웨이 타임아웃
게이트웨이/프록시가 업스트림 서버의 응답을 제한 시간 안에 받지 못했다는 응답입니다. 뒷단이 너무 느릴 때 납니다.
언제 발생하나
느린 DB 쿼리, 지연되는 외부 API 호출, 서버리스 함수 실행 시간 초과에서 발생합니다.
실무 대응
- 업스트림 작업이 왜 느린지(쿼리·외부 호출) 프로파일링합니다.
- 함수 실행 한도를 늘리거나(maxDuration) 오래 걸리는 작업을 비동기·백그라운드로 분리합니다.
- 외부 호출에 타임아웃·재시도·캐시를 넣어 게이트웨이 한도 전에 응답하게 합니다.
💡 실무 메모: Vercel 함수 타임아웃이 504/FUNCTION_INVOCATION_TIMEOUT으로 나타납니다. 스트리밍·작업 분할로 해결하세요.