Not Implemented

개요

501 Not Implemented는 서버가 요청을 처리하는 데 필요한 기능 자체를 지원하지 않는다는 뜻입니다. 서버가 인식하지 못하는 요청 메서드이거나, 아직 구현되지 않은 기능을 호출했을 때 반환됩니다.

405 Method Not Allowed와 비슷해 보이지만 차이가 있습니다. 405는 '해당 메서드를 알지만 이 리소스에는 허용하지 않는다'이고, 501은 '해당 기능/메서드를 서버가 아예 구현하지 않았다'는 서버 측 한계입니다.

언제 발생하나

• 서버가 지원하지 않는 HTTP 메서드(예: 드문 확장 메서드)를 사용했을 때
• 아직 개발되지 않은 엔드포인트나 기능을 호출했을 때
• 프록시·게이트웨이가 특정 기능을 중계할 수 없을 때

요청 / 응답 예시

PATCH /api/resource HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"x":1}

HTTP/1.1 501 Not Implemented
Content-Type: text/plain

The server does not support the functionality required to fulfill this request.

코드로 보기

app.all('/api/experimental', (req, res) => {
  res.status(501).send('Not Implemented');
});

# Reject methods the server does not implement
if ($request_method !~ ^(GET|POST|HEAD)$) {
  return 501;
}

실무 참고

• 501은 서버가 '전혀 지원하지 않는' 경우입니다. 일시적 장애가 아니므로 재시도해도 동일하게 실패합니다.
• 명세상 501 응답은 기본적으로 캐시 가능하므로, 나중에 기능을 구현할 계획이라면 캐시 헤더에 주의하세요.

관련 상태코드

관련 헤더

스펙 근거