405클라이언트 오류(4xx)
405 Method Not Allowed — 허용되지 않은 메서드
리소스는 존재하지만 사용한 HTTP 메서드(GET/POST 등)를 그 엔드포인트가 허용하지 않는다는 응답입니다.
언제 발생하나
GET 전용 라우트에 POST를 보내거나, API 핸들러가 특정 메서드만 처리하도록 작성된 경우 발생합니다.
실무 대응
- 엔드포인트가 기대하는 메서드(GET/POST/PUT/DELETE)와 요청 메서드를 일치시킵니다.
- API 라우트에서 req.method를 분기 처리하고, 미지원 메서드엔 405와 Allow 헤더를 응답합니다.
- 정적 호스팅에 POST를 보내면 405가 날 수 있으니 서버리스/서버 라우트로 보냅니다.
💡 실무 메모: Next.js API 라우트(App Router)는 export한 메서드 함수(GET/POST)만 허용하고 나머지는 자동 405입니다.