Not Acceptable

개요

406 Not Acceptable은 서버가 요청의 Accept 계열 헤더가 요구하는 형식으로 응답을 만들 수 없을 때 반환됩니다. 즉 콘텐츠 협상(content negotiation)이 실패한 상황입니다.

예컨대 클라이언트가 Accept: application/xml만 허용했는데 서버는 JSON만 제공할 수 있다면, 어떤 표현도 조건을 만족하지 못해 406으로 응답합니다.

언제 발생하나

• 클라이언트의 Accept 헤더가 서버가 생산할 수 없는 미디어 타입만 요구할 때 반환됩니다.
• Accept-Language나 Accept-Encoding이 지나치게 제한적이어서 서버가 만족시킬 표현을 못 찾을 때도 발생할 수 있습니다.

요청 / 응답 예시

GET /api/report HTTP/1.1
Host: api.example.com
Accept: application/xml

HTTP/1.1 406 Not Acceptable
Content-Type: application/json

{"error":"not_acceptable","supported":["application/json"]}

코드로 보기

app.get('/api/report', (req, res) => {
  if (!req.accepts('json'))
    return res.status(406).json({ supported: ['application/json'] });
  res.json(report);
});

실무 참고

• 많은 서버는 협상 실패 시 406 대신 관용적으로 기본 형식(예: JSON)을 그냥 반환하기도 하므로, 406은 상대적으로 드물게 보입니다.
• 요청 본문의 형식이 지원되지 않는 경우(업로드 쪽 문제)는 406이 아니라 415 Unsupported Media Type이 맞습니다.
• 406은 응답(서버가 생산할 형식) 협상 실패, 415는 요청(서버가 수용할 형식) 문제라는 방향 차이를 기억하면 헷갈리지 않습니다.

관련 상태코드

관련 헤더

스펙 근거