requests POST 리다이렉트: 301을 만나면 GET으로 바뀌는 문제 재현

requests POST 리다이렉트는 조용히 실패합니다. 서버가 301이나 302로 응답하면 requests는 다음 요청을 POST가 아니라 GET으로 보내고 본문도 버립니다. 그 GET이 200을 돌려주면 코드는 성공으로 끝나는데 서버에는 아무것도 만들어지지 않습니다. 정말 그런지, 다른 HTTP 클라이언트는 어떤지 로컬 서버를 띄워 상태 코드 5개와 메서드 4개를 전부 보내 봤습니다.

먼저 결론

  • requests는 301·302·303 응답을 따라갈 때 POST를 GET으로 바꾸고 본문을 버립니다. 307·308에서만 POST와 본문이 유지됩니다.
  • 이때 응답은 200이고 raise_for_status()도 예외를 내지 않습니다. 상태 코드만 봐서는 실패를 알 수 없습니다.
  • PUT·PATCH·DELETE는 클라이언트마다 다르게 움직입니다. requests는 301에서 메서드는 그대로 두고 본문만 비워 보냈습니다.
  • 쓰기 요청은 allow_redirects=False로 보내고 3xx를 직접 오류로 처리하는 편이 안전합니다.

실험 환경과 방법

macOS 27.2.1(Apple M4 Pro)에서 Python 3.11.15, requests 2.34.2, httpx 0.28.1, curl 8.7.1, Node.js 24.22.1로 실험했습니다. 서버는 파이썬 표준 라이브러리 http.server로 만들었습니다. /r/301처럼 요청하면 그 상태 코드로 /final에 넘기고, /final은 실제로 도착한 메서드와 본문 길이를 JSON으로 돌려줍니다.

import json
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer


class Handler(BaseHTTPRequestHandler):
    protocol_version = "HTTP/1.1"

    def _handle(self):
        length = int(self.headers.get("Content-Length") or 0)
        body = self.rfile.read(length) if length else b""
        if self.path.startswith("/r/"):  # /r/301 이면 301 로 /final 에 넘긴다
            self.send_response(int(self.path.split("/")[2]))
            self.send_header("Location", "/final")
            self.send_header("Content-Length", "0")
            self.end_headers()
            return
        payload = json.dumps({"method": self.command, "body_len": len(body)}).encode()
        self.send_response(200)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(payload)))
        self.end_headers()
        self.wfile.write(payload)

    do_GET = do_POST = do_PUT = do_PATCH = do_DELETE = _handle


server = ThreadingHTTPServer(("127.0.0.1", 0), Handler)  # 빈 포트를 자동으로 고른다

클라이언트는 18바이트짜리 JSON 본문을 실어 보냅니다. 돌아온 메서드와 본문 길이를 보면 리다이렉트 뒤에 무엇이 도착했는지 알 수 있습니다.

import requests

BODY = b'{"title": "hello"}'  # 18바이트


def via_requests(base, method, code):
    resp = requests.request(
        method,
        f"{base}/r/{code}",
        data=BODY,
        headers={"Content-Type": "application/json"},
        timeout=5,
    )
    seen = resp.json()
    return f'{seen["method"]}({seen["body_len"]})'

requests POST 리다이렉트 결과

표의 값은 /final에 도착한 메서드이고 괄호 안은 도착한 본문의 바이트 수입니다.

보낸 메서드 301 302 303 307 308
POST GET(0) GET(0) GET(0) POST(18) POST(18)
PUT PUT(0) GET(0) GET(0) PUT(18) PUT(18)
PATCH PATCH(0) GET(0) GET(0) PATCH(18) PATCH(18)
DELETE DELETE(0) GET(0) GET(0) DELETE(18) DELETE(18)

POST는 301·302·303에서 모두 GET이 됐고 본문은 0바이트였습니다. 의외였던 것은 PUT·PATCH·DELETE의 301입니다. 메서드는 그대로인데 본문만 사라졌습니다. 도착한 요청의 헤더를 찍어 보니 Content-Length는 0이었고 Content-Type 헤더는 없었습니다. 서버는 빈 PUT을 받은 셈이라 구현에 따라 400을 돌려줄 수도, 빈 값으로 덮어쓸 수도 있습니다.

다른 클라이언트는 어떻게 다른가

같은 요청을 httpx, urllib, curl, Node.js의 fetch로도 보냈습니다. POST가 301·302·303에서 GET으로 바뀌는 것은 다섯 클라이언트가 모두 같았습니다(curl은 -X 없이 -d만 쓴 경우입니다). 차이는 나머지 메서드에서 나왔습니다. 아래는 PUT을 보냈을 때의 결과이고 PATCH와 DELETE도 같았습니다.

클라이언트 301 302 303 307 308
requests 2.34.2 PUT(0) GET(0) GET(0) PUT(18) PUT(18)
httpx 0.28.1 PUT(18) GET(0) GET(0) PUT(18) PUT(18)
Node.js 24 fetch PUT(18) PUT(18) GET(0) PUT(18) PUT(18)
curl -L -X PUT -d PUT(0) PUT(0) PUT(0) PUT(18) PUT(18)
urllib.request HTTPError HTTPError HTTPError HTTPError HTTPError
  • 302에서 PUT과 본문을 모두 유지한 것은 Node.js의 fetch뿐이었습니다. requests와 httpx는 GET으로 바꿨습니다.
  • curl에 -X로 메서드를 지정하면 리다이렉트 뒤에도 그 메서드를 쓰지만 301·302·303에서는 본문이 빠졌습니다. -X POST도 마찬가지여서 본문 없는 POST가 도착했습니다.
  • urllib은 PUT·PATCH·DELETE의 리다이렉트를 따라가지 않고 HTTPError를 냈습니다. POST도 307·308에서는 HTTPError였습니다. 조용히 넘어가지 않는다는 점에서는 가장 안전한 동작입니다.

curl에서 -X 없이 -d만 쓰면 requests의 POST와 같은 결과가 나왔습니다. --post301 --post302 --post303을 붙이면 다섯 코드 모두에서 POST와 본문 18바이트가 유지됐습니다.

왜 GET으로 바뀌는가

버그가 아니라 표준이 허용한 동작입니다. RFC 9110은 301과 302에 대해 사용자 에이전트가 역사적인 이유로 POST를 GET으로 바꿀 수 있다고 적고, 그 동작을 원하지 않으면 308과 307을 쓰라고 안내합니다. 303은 처음부터 GET으로 다시 요청하라는 뜻입니다.

문제는 POST에 301이나 302가 돌아오는 상황이 흔하다는 점입니다. 주소를 http://로 적었는데 서버가 https://로 넘기는 경우, 끝에 슬래시가 없는 주소를 슬래시 붙은 주소로 넘기는 경우가 그렇습니다. 둘 다 GET으로 테스트할 때는 티가 나지 않습니다.

200인데 아무것도 만들어지지 않는 상황

/posts를 301로 /posts/에 넘기는 서버를 만들고 슬래시 없는 주소로 글 생성 요청을 보냈습니다. 이 서버에서 POST /posts/는 글을 만들고 201을, GET /posts/는 글 목록을 200으로 돌려줍니다.

>>> resp = requests.post(f"{base}/posts", json={"title": "hello"}, timeout=5)
>>> resp.status_code
200
>>> resp.ok
True
>>> [r.status_code for r in resp.history]
[301]
>>> resp.request.method
'GET'
>>> resp.text
'[]'
>>> resp.raise_for_status()   # 예외 없음
# 서버에 만들어진 글: 0개

상태 코드는 200이고 raise_for_status()도 통과했습니다. 그런데 마지막 요청은 GET이었고 서버에 만들어진 글은 0개입니다. 돌아온 본문 []는 빈 글 목록입니다. 응답에서 새 글의 ID를 꺼내 쓰는 코드라면 여기서 오류라도 나겠지만, 상태 코드만 확인하는 코드는 성공으로 기록하고 넘어갑니다.

대처 방법

1. 최종 주소로 보냅니다. 스킴과 끝 슬래시까지 서버가 마지막에 받는 주소와 똑같이 적습니다. 가장 단순하지만 서버 설정이 바뀌면 다시 깨집니다.

2. 쓰기 요청은 리다이렉트를 따라가지 않게 합니다. allow_redirects=False로 보내면 3xx 응답이 그대로 돌아옵니다. 주의할 점이 있습니다. raise_for_status()는 4xx와 5xx에만 예외를 냅니다. 실험에서 301 응답에 raise_for_status()를 불렀을 때도 예외가 나지 않았습니다. 3xx는 직접 검사해야 합니다.

def create_post(url, payload):
    resp = requests.post(url, json=payload, timeout=10, allow_redirects=False)
    if resp.is_redirect:
        raise RuntimeError(
            f"POST 가 {resp.status_code} 로 리다이렉트됐습니다: {resp.headers['Location']}"
        )
    resp.raise_for_status()
    return resp.json()

이 함수를 슬래시 없는 주소로 부르면 POST 가 301 로 리다이렉트됐습니다: /posts/ 예외가 났고, 최종 주소로 부르면 {'id': 1}이 돌아왔습니다.

3. 리다이렉트를 따라가야 한다면 history를 확인합니다. 리다이렉트를 거친 응답은 resp.history에 중간 응답이 남습니다. 처음 보낸 메서드와 마지막 요청의 메서드가 다르면 바뀐 것입니다.

resp = requests.post(url, json=payload, timeout=10)
sent = resp.history[0].request.method if resp.history else resp.request.method
if sent != resp.request.method:
    raise RuntimeError(f"{sent} 가 리다이렉트 뒤에 {resp.request.method} 로 바뀌었습니다")

4. 서버를 고칠 수 있으면 308을 씁니다. 같은 서버의 리다이렉트를 308로 바꾸자 클라이언트 코드를 건드리지 않고도 201이 돌아왔고 글이 만들어졌습니다.

이 실험의 한계

로컬의 HTTP/1.1 서버 하나로 확인한 결과입니다. 다른 호스트로 넘어가는 리다이렉트에서 인증 헤더가 어떻게 되는지, HTTPS에서 달라지는 점이 있는지는 다루지 않았습니다. 라이브러리 버전이 다르면 결과도 다를 수 있습니다. PUT·PATCH·DELETE는 클라이언트마다 달랐으므로, 쓰고 있는 라이브러리로 위 서버 코드를 한 번 돌려 보는 것을 권합니다.

함께 읽으면 좋은 글

Similar Posts

One Comment

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다