Permanent Redirect

개요

308 Permanent Redirect는 리소스가 영구히 새 URL로 이동했음을 알리면서, 클라이언트가 원래의 HTTP 메서드와 본문을 그대로 유지해 재요청하도록 요구합니다. 한마디로 301의 메서드 보존 버전입니다.

301이 과거 관행상 POST를 GET으로 바꿔 처리되기도 했던 문제를 없앴기 때문에, POST·PUT 같은 비-GET 요청의 영구 이전에 정확한 코드입니다.

언제 발생하나

• API 버전 이전(v1→v2)이나 엔드포인트의 영구 이동에서, 쓰기 요청의 메서드와 본문을 잃지 않고 새 URL로 옮겨야 할 때 사용합니다.
• 도메인·경로를 영구 변경하되 폼 POST나 API 호출을 그대로 보존해야 하는 상황에 적합합니다.

요청 / 응답 예시

PUT /v1/items/9 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"name":"Widget"}

HTTP/1.1 308 Permanent Redirect
Location: https://api.example.com/v2/items/9
Content-Length: 0

(client re-sends the SAME PUT with its body to the new URL, permanently)

코드로 보기

# permanently move /v1/* to /v2/* keeping method + body
location /v1/ {
    return 308 /v2/$uri;
}

app.all('/v1/items/:id', (req, res) => {
  res.redirect(308, `/v2/items/${req.params.id}`);
});

실무 참고

• 영구 리다이렉트라 브라우저가 캐시하므로, 잘못 설정하면 되돌리기 어렵습니다. 확정 전에는 307로 시험하는 편이 안전합니다.
• 단순 페이지의 영구 이전이고 메서드 보존이 필요 없다면 오래되고 널리 지원되는 301도 무난합니다.
• 임시 이동이면 308이 아니라 307을, GET으로의 전환이 필요하면 303을 사용합니다.

관련 상태코드

관련 헤더

스펙 근거