Expectation Failed

개요

417 Expectation Failed는 요청의 Expect 헤더에 담긴 기대(가장 흔하게는 Expect: 100-continue)를 서버가 충족할 수 없다는 뜻입니다. 클라이언트는 큰 본문을 보내기 전에 서버가 받아줄지 미리 확인하려고 Expect: 100-continue를 보냅니다.

서버나 중간 프록시가 이 메커니즘을 이해하지 못하면 100 Continue 대신 417을 반환합니다. 대부분 Expect 헤더를 제거하고 그냥 본문을 전송하면 해결됩니다.

언제 발생하나

• 큰 업로드 전에 Expect: 100-continue를 보냈지만 서버가 이를 지원하지 않을 때
• 구형 서버나 프록시가 100-continue 핸드셰이크를 처리하지 못할 때
• 표준 밖의 Expect 값을 서버가 인식하지 못할 때

요청 / 응답 예시

POST /large-upload HTTP/1.1
Host: api.example.com
Expect: 100-continue
Content-Length: 10485760

HTTP/1.1 417 Expectation Failed
Content-Type: text/plain

Expectation given in Expect header could not be met.

코드로 보기

# Some proxies choke on 100-continue; send an empty Expect to skip it
curl -X POST --data-binary @big.bin \
  -H 'Expect:' \
  https://api.example.com/large-upload

> POST /large-upload HTTP/1.1
> Expect: 100-continue
>
< HTTP/1.1 100 Continue      (server OK -> client sends body)
< HTTP/1.1 417 Expectation Failed   (server refuses the expectation)

실무 참고

• 일부 HTTP 클라이언트는 본문이 1KB를 넘으면 자동으로 Expect: 100-continue를 붙입니다. 원인 모를 지연이나 417이 보이면 이 헤더를 의심하세요.
• Expect 헤더는 100-continue 외의 값이 표준화되지 않아, 다른 값을 쓰면 대부분 417이 납니다.

관련 상태코드

관련 헤더

스펙 근거