502 잘못된 게이트웨이 - DecompressionFailureAtResponse

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

증상

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

오류 메시지

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

HTTP/1.1 502 Bad Gateway

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

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

가능한 원인

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

• HTTP 응답 (백엔드/대상 서버) 헤더에 지정된 인코딩 Content-Encoding은(는) 유효하며 <ph type="x-smartling-placeholder"></ph> 지원이 될 수 있으며

그러나

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

이는 Apigee Edge가 지정된 인코딩을 사용하여 페이로드를 디코딩하지 못하기 때문에 형식이 Content-Encoding 헤더.

<ph type="x-smartling-placeholder">

지원되는 Content-Encoding 값의 몇 가지 예시와 Apigee Edge가 작동하는 방식은 다음과 같습니다. 다음과 같은 경우에는 페이로드 표현이 필요합니다.

시나리오	Content-Encoding	페이로드 표현
단일 인코딩	gzip	Unix gzip 형식 자세한 내용은 <ph type="x-smartling-placeholder"></ph> RFC1952 GZIP 형식
단일 인코딩	수축하다	이 형식은 무손실 압축 알고리즘과 함께 zlib 구조를 사용합니다. 를 참조하세요. RFC1950 및 <ph type="x-smartling-placeholder"></ph> RFC1951.
다중 인코딩	다중 인코딩 예를 들어 인코딩이 두 번 실행되는 경우 다음과 같습니다. gzip, 압축 해제 gzip, gzip 압축, gzip deflate, deflate	다중 인코딩이 헤더에 표시되는 대로 페이로드에 지정된 순서대로 적용됩니다.

이 오류가 발생할 수 있는 원인은 다음과 같습니다.

원인	설명	다음에 관한 문제 해결 안내
<ph type="x-smartling-placeholder"></ph> 응답 페이로드 형식이 Content-Encoding과 일치하지 않습니다.	백엔드/대상 서버에서 전송한 응답 페이로드의 형식은 인코딩되지 않았거나 Content-Encoding 헤더에 지정된 인코딩과 일치합니다.	에지 퍼블릭 및 프라이빗 클라우드 사용자

일반적인 진단 단계

다음 도구/기술 중 하나를 사용하여 이 오류를 진단합니다.

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

응답 헤더가 풀리면 기본적으로 Apigee Edge는 항상 페이로드의 압축을 해제합니다. Content-Encoding에는 유효한 및 <ph type="x-smartling-placeholder"></ph> 지원되는 인코딩을 사용해야 합니다. 따라서 응답 페이로드의 형식이 응답 헤더 Content-Encoding에 지정된 인코딩과 일치해야 합니다. 불일치가 있는 경우 이 오류가 표시됩니다.

진단

1. API를 사용하여 관찰된 오류의 결함 코드 및 오류 소스 확인 다음 도움말에 설명된 대로 Monitoring, Trace 도구 또는 NGINX 액세스 로그 일반적인 진단 단계.
2. 결함 코드가 messaging.adaptors.http.flow.DecompressionFailureAtResponse 및 결함 소스의 값이 target이면 백엔드/대상 서버에서 전송한 응답 페이로드의 형식이 <ph type="x-smartling-placeholder"></ph> 응답 헤더 Content-Encoding에 지정된 지원되는 인코딩을 사용해야 합니다.

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

   오류 메시지

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

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

      샘플 오류 메시지:

      "faultstring":"Decompression failure at response"
      

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

   Trace

   Trace를 사용하여 검사하려면 다음 안내를 따르세요.

   1. Content-Type과 error.cause를 결정합니다. Trace를 사용하여 일반적인 진단 단계

   2. 샘플 trace의 값은 다음과 같습니다.

      • 콘텐츠 인코딩: 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. Private Cloud 사용자인 경우 메시지 프로세서 중 하나에서 백엔드 서버로 보냅니다.
   3. 백엔드 서버에서 보낸 응답을 검토하고 값 확인 응답 헤더 Content-Encoding.에 전달됨
   4. 요청의 일부로 전송되는 페이로드 형식을 확인합니다.
   5. Content-Encoding 헤더의 값이 <ph type="x-smartling-placeholder"></ph> 지원되지만 응답 페이로드 형식은 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)>
      

      위의 샘플 응답은 gzip 값을 Content-Encoding 헤더로, <ph type="x-smartling-placeholder"></ph> 지원되는 인코딩을 참고하세요. 그러나 response_payload.zip 파일은 ZIP 파일로 전송됩니다. 따라서 다음 오류 코드와 함께 502 Bad Gateway 오류와 함께 응답이 실패합니다. messaging.adaptors.http.flow.DecompressionFailureAtResponse

   메시지 프로세서 로그

   <ph type="x-smartling-placeholder">

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

   프라이빗 클라우드 사용자인 경우 메시지 프로세서 로그를 사용할 수 있습니다. 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 응답에 콘텐츠 인코딩 헤더가 있는 경우: 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으로 지정됩니다 따라서 Apigee Edge는 예외를 발생시키고 오류 코드가 있는 502 상태 코드 반환 messaging.adaptors.http.flow.DecompressionFailureAtResponse 클라이언트 애플리케이션에 배포될 수 있습니다

      시나리오 #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는 예외가 발생하고 다음과 함께 502 상태 코드를 반환합니다. 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse 클라이언트 애플리케이션에 배포될 수 있습니다

해상도

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

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

   </ph>

   >
   < 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)>
   

   <ph type="x-smartling-placeholder">

사양

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

사양
<ph type="x-smartling-placeholder"></ph> RFC 7231, 섹션 6.5.1
<ph type="x-smartling-placeholder"></ph> RFC 7231, 섹션 3.1.2.2

Apigee 지원팀의 도움이 더 필요하면 로 이동하세요. 진단 정보를 수집해야 합니다.

진단 정보 수집 필요

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

퍼블릭 클라우드 사용자인 경우 다음 정보를 입력합니다.

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

Private Cloud 사용자인 경우 다음 정보를 입력합니다.

• 실패한 응답에 대해 발견된 전체 오류 메시지
• 환경 이름
• 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