502 잘못된 게이트웨이 - DecompressionFailureAtResponse

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. info

증상

클라이언트 애플리케이션은 API 호출에 대한 응답으로 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse와 함께 HTTP 상태 코드 502 Bad Gateway를 받습니다.

오류 메시지

클라이언트 애플리케이션은 다음 응답 코드를 받습니다.

HTTP/1.1 502 Bad Gateway

또한 아래와 유사한 오류 메시지가 표시될 수 있습니다.

{
   "fault":{
      "faultstring":"Decompression failure at response",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"
      }
   }
}

가능한 원인

이 오류는 다음과 같은 경우에만 발생합니다.

• HTTP 응답 (백엔드/대상 서버에서) 헤더 Content-Encoding에 지정된 인코딩이 올바르고 Apigee Edge에서 지원됩니다.

그러나

• 백엔드/대상 서버에서 HTTP 응답의 일부로 전송된 페이로드 형식이 Content-Encoding 헤더에 지정된 인코딩 형식과 일치하지 않습니다.

페이로드 형식이 Content-Encoding 헤더에 지정된 인코딩과 동일한 형식이 아니므로 Apigee Edge가 지정된 인코딩을 사용하여 페이로드를 디코딩하지 못하기 때문입니다.

다음은 지원되는 Content-Encoding 값과 Apigee Edge가 이러한 경우 페이로드 표현을 어떻게 예상하는지에 관한 몇 가지 예입니다.

이 오류의 가능한 원인은 다음과 같습니다.

일반적인 진단 단계

다음 도구/기법 중 하나를 사용하여 이 오류를 진단하세요.

원인: 응답 페이로드 형식이 Content-Encoding과 일치하지 않음

기본적으로 Apigee Edge는 응답 헤더 Content-Encoding에 유효하고 지원되는 인코딩이 포함된 경우 항상 페이로드를 압축 해제합니다. 따라서 응답 페이로드의 형식이 응답 헤더 Content-Encoding에 지정된 인코딩과 일치해야 합니다. 불일치가 있으면 이 오류가 표시됩니다.

진단

1. 일반적인 진단 단계에 설명된 대로 API 모니터링, Trace 도구 또는 NGINX 액세스 로그를 사용하여 관찰된 오류의 오류 코드와 오류 소스를 확인합니다.
2. 오류 코드가 messaging.adaptors.http.flow.DecompressionFailureAtResponse이고 오류 소스 값이 target이면 백엔드/대상 서버에서 전송된 응답 페이로드 형식이 응답 헤더 Content-Encoding에 지정된 지원되는 인코딩과 일치하지 않음을 나타냅니다.

3. 다음 방법 중 하나를 사용하여 HTTP 응답의 일부로 불일치를 확인할 수 있습니다.

   오류 메시지

   오류 메시지를 사용하여 유효성을 검사하려면 다음 단계를 따르세요.

   1. Apigee Edge에서 수신한 전체 오류 메시지에 액세스할 수 있는 경우 faultstring를 참고하세요.

      샘플 오류 메시지:

      "faultstring":"Decompression failure at response"

   2. 위의 오류 메시지에는 "Decompression failure at response"이 표시됩니다. 이는 Content-Encoding 헤더에 지정된 인코딩을 사용하여 응답을 압축 해제할 수 없음을 의미합니다.

   Trace

   Trace를 사용하여 검증하려면 다음 단계를 따르세요.

   1. 일반적인 진단 단계에 설명된 대로 Trace를 사용하여 Content-Type 및 error.cause를 확인합니다.

   2. 샘플 트레이스의 값은 다음과 같습니다.

      • Content-Encoding: gzip
      • error.cause: Not in GZIP format

      응답 헤더 Content-Encoding의 값은 gzip이지만 응답 페이로드는 GZIP 형식이 아닙니다(error.cause에 표시됨). 따라서 Apigee Edge는 502 Bad Gateway 및 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse로 응답합니다.

   실제 요청

   실제 요청을 사용하여 검증하려면 다음 단계를 따르세요.

   타겟/백엔드 서버 애플리케이션에 전송된 실제 요청에 액세스할 수 있는 경우 다음 단계를 실행합니다.

   1. 공용 클라우드/비공개 클라우드 사용자인 경우 백엔드 서버 자체 또는 백엔드 서버에 요청을 보낼 수 있는 다른 머신에서 백엔드 서버에 직접 요청하세요.
   2. 비공개 클라우드 사용자인 경우 메시지 프로세서 중 하나에서 백엔드 서버로 요청을 보낼 수도 있습니다.
   3. 백엔드 서버에서 전송한 응답을 검사하고 응답 헤더 Content-Encoding.에 전달된 값을 확인합니다.
   4. 요청의 일부로 전송된 페이로드의 형식을 확인합니다.
   5. Content-Encoding 헤더의 값이 지원되는 인코딩 목록에 있지만 응답 페이로드 형식이 Content-Encoding 헤더에 지정된 인코딩과 일치하지 않으면 문제가 발생합니다.

      샘플:

      curl -v https://HOSTALIAS/test
      

      ***trimmed***
      >
      < HTTP/1.1 200 OK
      < Accept-Ranges: bytes
      < Content-Encoding: gzip
      < Date: Mon, 02 Aug 2021 08:17:35 GMT
      < Transfer-Encoding: chunked
      <
      < response_payload.zip Response Body(not in GZIP format)>
      

      위 샘플 응답은 Apigee Edge에서 지원되는 인코딩인 Content-Encoding 헤더에 gzip 값을 전송합니다. 하지만 response_payload.zip은 ZIP 파일로 전송됩니다. 따라서 이 응답은 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse이 포함된 502 Bad Gateway 오류와 함께 실패합니다.

   메시지 프로세서 로그

   메시지 프로세서 로그를 사용하여 유효성을 검사하려면 다음 단계를 따르세요.

   프라이빗 클라우드 사용자인 경우 메시지 프로세서 로그를 사용하여 HTTP 502 오류에 관한 주요 정보를 확인할 수 있습니다.

   1. 메시지 프로세서 로그를 확인합니다.

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   2. 특정 기간 동안 502 오류가 있는지 (문제가 과거에 발생한 경우) 또는 502로 인해 여전히 실패하는 응답이 있는지 검색합니다. 다음 검색 문자열을 사용할 수 있습니다.

      grep -ri "ZipException"
      

   3. system.log에서 다음과 비슷한 줄을 찾을 수 있습니다.

      시나리오 #1

      시나리오 1: API 응답에 Content-Encoding: gzip 헤더가 있는 경우

      2021-08-02 06:50:25,433  NIOThread@2 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :  ClientInputChannel(ClientChannel[Connected:
      Remote:3.8.1.1:9000 Local:10.0.115.32:41298]@38140 useCount=1 bytesRead=0
      bytesWritten=203 age=469ms  lastIO=0ms  isOpen=true).onExceptionRead exception: {}
      java.util.zip.ZipException: Not in GZIP format
      ---trimmed--
      2021-08-02 06:50:25,433  NIOThread@2 INFO  HTTP.CLIENT -
      HTTPClient$Context.logContextDetails() : Request details : host=null
      path=/folder/testFile method=GET. Channel details : Bytes read=0
      2021-08-02 06:50:25,434  NIOThread@2 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError(HTTPResponse@4806fdab, Not in GZIP format)
      2021-08-02 06:50:25,434  NIOThread@2 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception
      java.util.zip.ZipException: Not in GZIP format
      occurred while writing to channel null
      2021-08-02 06:50:25,434  NIOThread@2 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: Not in GZIP format
      

      위 오류 메시지의 java.util.zip.ZipException: Not in GZIP format 줄은 Content-Encoding이 gzip으로 지정되었지만 응답 페이로드가 GZIP 형식으로 전송되지 않았음을 나타냅니다. 따라서 Apigee Edge는 예외를 발생시키고 클라이언트 애플리케이션에 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse와 함께 502 상태 코드를 반환합니다.

      시나리오 #2

      시나리오 2: API 응답에 Content-Encoding: deflate 헤더가 있는 경우

      2021-08-02 06:35:21,215  NIOThread@0 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :  ClientInputChannel(ClientChannel[Connected:
      Remote:3.8.1.1:9000 Local:192.168.194.140:35224]@36014 useCount=1 bytesRead=0
      bytesWritten=202 age=439ms  lastIO=2ms  isOpen=true).onExceptionRead exception: {}
      java.util.zip.ZipException: incorrect header check
      ---trimmed----
      Caused by:
      java.util.zip.DataFormatException: incorrect header check
      ---trimmed---
      2021-08-02 06:35:21,215  NIOThread@0 INFO  HTTP.CLIENT -
      HTTPClient$Context.logContextDetails() : Request details :
      host=null path=/folder/testFile method=GET. Channel details : Bytes read=0
      2021-08-02 06:35:21,216  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError(HTTPResponse@3966e277,
      incorrect header check)
      2021-08-02 06:35:21,216  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception
      java.util.zip.ZipException: incorrect header check occurred while writing to channel null
      2021-08-02 06:35:21,217  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: incorrect header check
      
      

      위 오류 메시지의 java.util.zip.ZipException: incorrect header check 및 Caused by: java.util.zip.DataFormatException: incorrect header check 줄은 응답 페이로드가 deflate 형식으로 전송되지 않으며 deflate의 Content-Encoding 헤더에 지정된 인코딩과 일치하지 않음을 나타냅니다. 따라서 Apigee Edge는 예외를 발생시키고 클라이언트 애플리케이션에 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse과 함께 502 상태 코드를 반환합니다.

해상도

1. Apigee Edge의 API 프록시 흐름과 백엔드 서버에 압축된 응답 페이로드가 필요하지 않은 경우 헤더 Content-Encoding를 전달하지 마세요. 응답 페이로드를 압축해야 하는 경우 2단계로 이동합니다.
2. 응답 페이로드를 압축해야 하는 경우 백엔드 서버가 항상 다음을 전송하는지 확인하세요.
   • 응답의 Content-Encoding 헤더 값으로 지원되는 인코딩 중 하나
   • Apigee Edge에 대한 지원되는 형식의 응답 페이로드가 Content-Encoding 헤더에 지정된 인코딩 형식과 일치합니다.
3. 위에서 설명한 예에서 응답 페이로드는 ZIP 형식인데 응답 헤더는 Content-Encoding: gzip을 지정합니다. 응답 헤더를 Content-Encoding: gzip로, 응답 페이로드를 gzip 형식으로 전송하여 문제를 해결할 수 있습니다.

   curl -v https://HOSTALIAS/v1/test
   

   >
   < HTTP/1.1 200 OK
   < Accept-Ranges: bytes
   < Content-Encoding: gzip
   < Date: Mon, 02 Aug 2021 08:17:35 GMT
   < Transfer-Encoding: chunked
   <
   < response_payload.gz Response Body(in GZIP format)>
   

사양

Apigee Edge는 다음 RFC 사양에 따라 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse와 함께 상태 코드 502 Bad Gateway로 응답합니다.

Apigee 지원팀의 지원이 여전히 필요한 경우 진단 정보를 수집해야 함으로 이동하세요.

진단 정보 수집 필요

다음 진단 정보를 수집한 후 Apigee Edge 지원팀에 문의합니다.

Public Cloud 사용자인 경우 다음 정보를 제공하세요.

• 조직 이름
• 환경 이름
• API 프록시 이름
• 502 오류를 재현하는 데 사용된 전체 curl 명령어
• API 응답의 추적 파일

프라이빗 클라우드 사용자인 경우 다음 정보를 제공하세요.

• 실패한 응답에 대해 확인된 전체 오류 메시지
• 환경 이름
• API 프록시 번들
• API 응답의 추적 파일

• NGINX 액세스 로그 /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  위치: ORG, ENV, PORT#이 실제 값으로 대체됩니다.

• 메시지 프로세서 시스템 로그 /opt/apigee/var/log/edge-message-processor/logs/system.log