TrueURL
TrueURL

메뉴

422 처리할 수 없는 콘텐츠

요청 형식은 올바르지만 콘텐츠가 의미상 유효하지 않습니다. 주로 API의 유효성 검사 오류이며, 이전 이름은 “Unprocessable Entity”입니다.

사유 구절
Unprocessable Content
리디렉션 여부
아니요
기본 캐시 가능 여부
아니요

422 Unprocessable Content는 서버가 콘텐츠 유형을 이해하고 요청 구문도 올바르지만, 그 안에 담긴 지시를 처리할 수 없다는 뜻입니다. 예를 들어 JSON 본문은 문제없이 파싱되지만 이메일 필드가 유효하지 않거나 필수 값이 허용 범위를 벗어난 경우입니다.

WebDAV(RFC 4918)가 이 코드를 “Unprocessable Entity”라는 이름으로 도입했고, RFC 9110이 새 이름으로 HTTP 핵심 명세에 포함했습니다. Ruby on Rails, Laravel 등 많은 웹 프레임워크와 API가 유효성 검사 오류에 이 코드를 사용하며, 본문에 필드별 메시지를 담아 반환합니다.

400과 422는 일관되게 사용하세요. 파싱할 수 없는 요청에는 400을, 파싱은 되지만 유효성 검사를 통과하지 못한 요청에는 422를 사용합니다.

응답 예시

HTTP
HTTP/1.1 422 Unprocessable Content
Date: Fri, 06 Nov 2026 10:15:32 GMT
Content-Type: application/json
Content-Length: 77

{"message":"Validation failed","errors":[{"field":"email","code":"invalid"}]}

SEO 및 리디렉션 검사

422는 API와 폼 처리에 쓰는 코드입니다. 크롤러는 GET을 사용하므로 이 코드를 볼 일이 없어야 하며, GET에 422를 반환하는 페이지는 4xx 오류로 취급되어 색인되지 않습니다.

주요 원인과 사용 사례

  • 폼 제출이나 API 호출이 유효성 검사를 통과하지 못했습니다. 필드가 빠졌거나, 이메일 주소가 유효하지 않거나, 이미 사용 중인 사용자 이름인 경우입니다.
  • 문서가 유효한 JSON이지만 API의 스키마와 일치하지 않습니다.
  • WebDAV PROPPATCH나 LOCK 본문이 형식상 올바른 XML이지만 의미상 잘못되었습니다.

URL 리디렉션 검사

무료 TrueURL 리디렉션 검사 도구로 URL이 반환하는 모든 상태 코드를 홉별로 확인하세요.