Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

페이로드 래핑 해제 문제 해결

이 페이지에서는 페이로드 래핑 해제와 관련된 문제를 해결하는 방법을 보여줍니다.

HTTP 상태 코드 오류

페이로드 래핑 해제를 사용할 때 일반적인 HTTP 상태 코드 오류가 발생할 수 있습니다. push_request_count 측정항목으로 오류를 모니터링할 수 있습니다.

Pub/Sub가 잘못된 구성 또는 누락된 데이터로 인해 요청을 처리할 수 없는 경우 다음 오류가 발생합니다.

400 Bad Request

이 오류는 여러 이유로 발생합니다. 이 오류의 가장 일반적인 원인은 다음과 같습니다.

이 문제를 해결하려면 다음 솔루션을 시도해 보세요.

페이로드의(메시지 데이터) 형식을 확인합니다. HTTP 엔드포인트에서 지정된 예상 요청 형식과 일치하는지 확인합니다.
요청에 필요한 헤더가 포함되어 있는지 확인합니다. 헤더가 누락된 경우 메시지 속성에 헤더를 추가해야 할 수 있습니다. 예를 들어 Content-Type을 포함해야 할 수 있지만 다른 헤더도 필요할 수 있습니다.
구독에 구성된 HTTP 엔드포인트가 유효한지 확인합니다.
푸시 구독에서 데드 레터 큐(DLQ)를 사용 설정합니다. 이렇게 하면 전송할 수 없는 개별 메시지가 리디렉션됩니다. 검사하려는 400 오류가 소수 있는 경우 DLQ를 사용 설정하는 것이 좋습니다.

Pub/Sub가 잘못되거나 유효하지 않은 사용자 인증 정보로 인해 요청을 처리할 수 없는 경우 다음 오류가 발생합니다.

401 unauthorized / 403 forbidden

이 오류는 푸시 구독이 인증되지 않았기 때문에 발생합니다.

이 문제를 해결하려면 다음 솔루션을 시도해 보세요.

푸시 인증을 사용 설정합니다. Cloud Run 또는 App Engine과 통합하는 경우 푸시 인증을 사용하는 것이 중요합니다.

푸시 인증이 솔루션과 호환되지 않는 경우 게시 메시지 속성에 자체 승인 키 또는 API 키를 추가해야 할 수 있습니다.

Pub/Sub가 페이로드 형식이 지원되지 않는 형식이기 때문에 요청을 처리할 수 없는 경우 다음 오류가 발생합니다.

415 Unsupported Media Type

이 오류는 여러 이유로 발생합니다. 이 오류의 가장 일반적인 원인은 다음과 같습니다.

이 문제를 해결하려면 다음 솔루션을 시도해 보세요.

엔드포인트에 Content-Type 헤더가 필요할 수 있습니다. 기본적으로 페이로드 래핑 해제는 미디어 유형 헤더를 설정하지 않습니다. 게시 메시지 속성으로 연결하여 Content-Type 헤더를 설정할 수 있습니다.

Pub/Sub가 요청에 전송된 콘텐츠가 너무 커서 요청을 처리할 수 없는 경우 다음 오류가 발생합니다.

431 request header fields too Large / 413 content too large

이 오류는 Pub/Sub 메시지의 속성이 서버의 헤더 크기 한도를 초과하는 경우에 발생합니다.

이 문제를 해결하려면 다음 솔루션을 시도해 보세요.

메타데이터 쓰기를 사용 중지합니다.
푸시 구독에서 데드 레터 큐(DLQ)를 사용 설정합니다. 이렇게 하면 전송할 수 없는 개별 메시지가 리디렉션됩니다. 그 후에는 구독이 계속 작동하지만 추가 분석을 위해 오류가 있는 메시지가 별도의 주제로 리디렉션됩니다.

Console에서 Google Cloud **구독** 페이지로 이동합니다.

Pub/Sub 구독 열기
서비스의 이름을 클릭합니다.

서비스 세부정보 페이지가 열립니다.
구성 표에서 메시지 데이터 래핑 해제 및 메시지 메타데이터 쓰기 값을 찾습니다.

페이로드 래핑 상태(사용 설정 또는 중지)가 해당 테이블 행에 표시됩니다.