502 잘못된 게이트웨이 - DecompressionFailureAtResponse

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

증상

클라이언트 애플리케이션은 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 페이로드 표현
단일 인코딩 gzip

Unix gzip 형식.

RFC1952 GZIP 형식을 참고하세요.

단일 인코딩 압축 해제하다

이 형식은 zlib 구조를 deflate 압축 알고리즘과 함께 사용합니다.

RFC1950 및 RFC1951.을 참조하세요.
다중 인코딩

다중 인코딩

예를 들어 인코딩이 두 번 실행되는 경우 다음과 같을 수 있습니다.

  • gzip, deflate, gzip, deflate, CANNOT TRANSLATE
  • gzip, gzip,
  • 압축, gzip, deflate, gzip
  • 디플레이트, deflate
 헤더에 표시되는 지정된 순서로 페이로드에 다중 인코딩이 적용됩니다.

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

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

일반적인 진단 단계

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

API 모니터링

API 모니터링을 사용하여 오류를 진단하려면 다음 안내를 따르세요.

  1. 적절한 역할이 있는 사용자로 Apigee Edge UI에 로그인합니다.

  2. 문제를 조사하려는 조직으로 전환합니다.

  3. 분석 > API 모니터링 > 조사 페이지로 이동합니다.
  4. 오류를 관찰한 특정 기간을 선택합니다.
  5. 프록시 필터가 모두로 설정되어 있는지 확인합니다.
  6. 시간을 기준으로 결함 코드를 표시합니다.

  7. 아래와 같이 오류 코드가 messaging.adaptors.http.flow.DecompressionFailureAtResponse인 셀을 선택합니다.

    ( 더 큰 이미지 보기)

  8. 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse에 관한 정보가 아래와 같이 표시됩니다.

    ( 더 큰 이미지 보기)

  9. 로그 보기를 클릭하고 502 오류와 함께 실패한 행을 펼칩니다.

    ( 더 큰 이미지 보기)

  10. 로그 창에서 다음 세부정보를 확인합니다.
    • 상태 코드: 502
    • 결함 소스: target
    • 오류 코드: messaging.adaptors.http.flow.DecompressionFailureAtResponse.
  11. 오류 소스의 값이 target이면 응답 페이로드 형식이 백엔드 서버의 응답 헤더 Content-Encoding에 지정된 지원되는 인코딩과 일치하지 않았음을 나타냅니다.

추적 도구

Trace 도구를 사용하여 오류를 진단하려면 다음 단계를 따르세요.

  1. trace 세션과 다음 중 하나를 사용 설정합니다.
    1. 502 Bad Gateway 오류가 발생할 때까지 기다립니다.
    2. 문제를 재현할 수 있는 경우 API를 호출하고 502 Bad Gateway를 재현합니다.

  2. Show all FlowInfos(모든 FlowInfos 표시)가 사용 설정되어 있는지 확인합니다.

  3. 실패한 응답 중 하나를 선택하고 트레이스를 검사합니다.
  4. trace의 여러 단계를 살펴보고 오류가 발생한 위치를 찾습니다.

  5. 일반적으로 아래와 같이 Response Received from target server 단계 직후에 흐름에서 오류가 표시됩니다.

    ( 더 큰 이미지 보기)

  6. 트레이스의 속성 값을 기록해 둡니다.

    • 콘텐츠 인코딩: gzip
    • 응답 콘텐츠 본문: {"fault":{"faultstring":"Decompression failure at response","detail":{"errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"}}}

  7. Response Received from target server 단계 바로 직후에 오류 단계로 이동합니다.

    ( 더 큰 이미지 보기)

    속성을 참고하세요.

    • 오류: Decompression failure at response
    • error.class: com.apigee.errors.http.server.BadGateway

    • error.cause: Not in GZIP format

      error.cause는 응답 페이로드가 GZIP 형식이 아님을 나타냅니다. 이는 Apigee Edge에서 응답 페이로드가 Content-Encoding 헤더에 지정된 GZIP 형식일 것으로 예상했음을 의미합니다. 따라서 Apigee Edge는 gzip을 사용하여 페이로드의 압축을 풀 수 없으며 Decompression failure at response 오류를 반환합니다.

    이 경우 대상/백엔드 서버의 응답은 200입니다. 그러나 Apigee Edge에서 오류를 반환하므로 클라이언트 애플리케이션에 502 응답이 수신됩니다.

  8. 추적에서 클라이언트에 전송된 응답 단계로 이동하여 클릭합니다.

    ( 더 큰 이미지 보기)

    트레이스에서 다음과 같은 세부정보를 확인합니다.

    • 상태 코드: 502 Bad Gateway.
    • 오류 콘텐츠: {"fault":{"faultstring":"Decompression failure at response","detail":{"errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"}}}

  9. 추적에서 AX (애널리틱스 데이터 기록됨) 단계로 이동하여 클릭합니다.

  10. 단계 세부정보, 오류 헤더 섹션까지 아래로 스크롤하여 아래와 같이 X-Apigee-fault-code 및 X-Apigee-fault-source의 값을 확인합니다.

    ( 더 큰 이미지 보기)

  11. X-Apigee-fault-code 및 X-Apigee-fault-source의 값이 messaging.adaptors.http.flow.DecompressionFailureAtResponse 및 target로 표시되어 응답 페이로드 형식이 Content-Encoding 헤더에 지정된 인코딩과 일치하지 않았음을 나타냅니다.
    응답 헤더 값
    X-Apigee-fault-code messaging.adaptors.http.flow.DecompressionFailureAtResponse
    X-Apigee-fault-source target

NGINX

NGINX 액세스 로그를 사용하여 오류를 진단하려면 다음 안내를 따르세요.

  1. Private Cloud 사용자는 NGINX 액세스 로그를 사용하여 HTTP 502 오류에 대한 주요 정보를 확인할 수 있습니다.

  2. NGINX 액세스 로그를 확인합니다.

    /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

    여기서 ORG, ENV, PORT#는 실제 값으로 대체됩니다.

  3. 특정 기간 동안 502 오류가 있는지(과거에 문제가 발생한 경우) 또는 여전히 502와 함께 실패하는 응답이 있는지 검색합니다.

  4. messaging.adaptors.http.flow.DecompressionFailureAtResponse 값과 일치하는 X-Apigee-fault-code가 포함된 502 오류가 발견되면 X-Apigee-fault-source의 값을 확인합니다.

    NGINX 액세스 로그의 샘플 502 오류:

    NGINX 액세스 로그의 위 샘플 항목에는 X-Apigee-fault-code 및 X-Apigee-fault-code 에 대한 값이 다음과 같습니다.

    응답 헤더 값
    X-Apigee-fault-code messaging.adaptors.http.flow.DecompressionFailureAtResponse
    X-Apigee-fault-source target

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

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

진단

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

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

    오류 메시지

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

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

      오류 메시지 샘플:

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

    Trace

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

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

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

      • 콘텐츠 인코딩: 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 헤더의 값이 지원되는 인코딩 목록에 있지만 응답 페이로드의 형식이 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 값을 Apigee Edge에서 지원되는 인코딩인 Content-Encoding 헤더로 전송합니다. 그러나 response_payload.zip은 ZIP 파일로 전송됩니다. 따라서 이 응답은 502 Bad Gateway 오류(오류 코드: messaging.adaptors.http.flow.DecompressionFailureAtResponse)로 인해 실패합니다.

    메시지 프로세서 로그

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

    Private Cloud 사용자는 메시지 프로세서 로그를 사용하여 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 사양에 따라 502 Bad Gateway 상태 코드로 오류 코드 messaging.adaptors.http.flow.DecompressionFailureAtResponse로 응답합니다.

사양
RFC 7231, 섹션 6.5.1
RFC 7231, 섹션 3.1.2.2

Apigee 지원의 도움이 더 필요하면 진단 정보 수집 필수로 이동하세요.

진단 정보 수집 필요

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

Public Cloud 사용자인 경우 다음 정보를 제공합니다.

  • 조직 이름
  • 환경 이름
  • 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