502 Bad Gateway - DecompressionFailureAtResponse

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Dấu hiệu

Ứng dụng khách nhận được mã trạng thái HTTP 502 Bad Gateway với mã lỗi messaging.adaptors.http.flow.DecompressionFailureAtResponse dưới dạng phản hồi cho các lệnh gọi API.

Thông báo lỗi

Ứng dụng khách nhận được mã phản hồi sau:

HTTP/1.1 502 Bad Gateway

Ngoài ra, bạn có thể thấy một thông báo lỗi tương tự như thông báo dưới đây:

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

Các nguyên nhân có thể

Lỗi này chỉ xảy ra nếu:

• Mã hoá được chỉ định trong tiêu đề phản hồi HTTP (từ máy chủ phụ trợ/máy chủ đích) Content-Encoding là hợp lệ và được Apigee Edge hỗ trợ,

NHƯNG

• Định dạng trọng tải do máy chủ phụ trợ/máy chủ đích gửi dưới dạng một phần của phản hồi HTTP không khớp với định dạng mã hoá được chỉ định trong tiêu đề Content-Encoding

Điều này là do Apigee Edge không giải mã được tải trọng bằng cách sử dụng phương thức mã hoá đã chỉ định vì định dạng của tải trọng không giống với định dạng của phương thức mã hoá được chỉ định trong tiêu đề Content-Encoding.

Sau đây là một số ví dụ về các giá trị Content-Encoding được hỗ trợ và cách Apigee Edge mong đợi biểu thị tải trọng trong những trường hợp đó:

Sau đây là những nguyên nhân có thể gây ra lỗi này:

Các bước chẩn đoán thường gặp

Hãy sử dụng một trong các công cụ/kỹ thuật sau để chẩn đoán lỗi này:

Nguyên nhân: Định dạng tải trọng phản hồi không khớp với Content-Encoding

Theo mặc định, Apigee Edge luôn giải nén tải trọng nếu tiêu đề phản hồi Content-Encoding chứa một mã hoá hợp lệ và được hỗ trợ. Do đó, định dạng của tải trọng phản hồi phải khớp với phương thức mã hoá được chỉ định trong tiêu đề phản hồi Content-Encoding. Nếu có sự không khớp, bạn sẽ gặp lỗi này.

Chẩn đoán

1. Xác định Mã lỗi và Nguồn lỗi cho lỗi quan sát được bằng cách sử dụng tính năng Giám sát API, công cụ Theo dõi hoặc nhật ký truy cập NGINX như được giải thích trong phần Các bước chẩn đoán thường gặp.
2. Nếu Mã lỗi là messaging.adaptors.http.flow.DecompressionFailureAtResponse và Nguồn lỗi có giá trị target, thì điều này cho biết rằng định dạng của tải trọng phản hồi do máy chủ phụ trợ/máy chủ đích gửi không khớp với mã hoá được hỗ trợ được chỉ định trong tiêu đề phản hồi Content-Encoding.

3. Bạn có thể xác định sự không khớp trong phản hồi HTTP bằng một trong các phương thức sau:

   Thông báo lỗi

   Cách xác thực bằng thông báo lỗi:

   1. Nếu bạn có quyền truy cập vào thông báo lỗi hoàn chỉnh nhận được từ Apigee Edge, hãy tham khảo faultstring.

      Thông báo lỗi mẫu:

      "faultstring":"Decompression failure at response"

   2. Trong thông báo lỗi ở trên, thông báo này hiển thị "Decompression failure at response", tức là phản hồi không thể giải nén bằng phương thức mã hoá được chỉ định trong tiêu đề Content-Encoding.

   Trace

   Cách xác thực bằng Trace:

   1. Xác định Content-Type và error.cause bằng cách sử dụng Trace như được giải thích trong phần Các bước chẩn đoán thường gặp.

   2. Các giá trị trong dấu vết mẫu như sau:

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

      Giá trị trong tiêu đề phản hồi Content-Encoding là gzip; tuy nhiên, tải trọng phản hồi không ở định dạng GZIP (như được chỉ ra bởi error.cause). Do đó, Apigee Edge sẽ phản hồi bằng 502 Bad Gateway và mã lỗi messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   Yêu cầu thực tế

   Cách xác thực bằng yêu cầu thực tế:

   Nếu bạn có quyền truy cập vào yêu cầu thực tế được gửi đến ứng dụng máy chủ đích/phụ trợ, hãy thực hiện các bước sau:

   1. Nếu bạn là người dùng Đám mây công khai/Đám mây riêng tư, hãy gửi yêu cầu trực tiếp đến máy chủ phụ trợ từ chính máy chủ phụ trợ hoặc bất kỳ máy nào khác mà bạn được phép gửi yêu cầu đến máy chủ phụ trợ.
   2. Nếu là người dùng Đám mây riêng tư, bạn cũng có thể gửi yêu cầu đến máy chủ phụ trợ từ một trong các Trình xử lý thông báo.
   3. Kiểm tra phản hồi do máy chủ phụ trợ gửi và xác định giá trị được truyền trong tiêu đề phản hồi Content-Encoding.
   4. Xác định định dạng của tải trọng được gửi trong yêu cầu.
   5. Nếu giá trị của tiêu đề Content-Encoding nằm trong danh sách mã hoá được hỗ trợ nhưng định dạng của tải trọng phản hồi không khớp với mã hoá được chỉ định trong tiêu đề Content-Encoding, thì đó là nguyên nhân gây ra vấn đề.

      Ví dụ:

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

      Phản hồi mẫu ở trên gửi giá trị gzip đến tiêu đề Content-Encoding. Đây là một mã hoá được hỗ trợ trong Apigee Edge. Tuy nhiên, response_payload.zip được gửi dưới dạng tệp zip. Do đó, phản hồi này không thành công do gặp lỗi 502 Bad Gateway với mã lỗi: messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   Nhật ký Trình xử lý tin nhắn

   Cách xác thực bằng nhật ký Message Processor:

   Nếu là người dùng Đám mây riêng, bạn có thể sử dụng nhật ký Trình xử lý thông báo để xác định thông tin chính về lỗi HTTP 502.

   1. Kiểm tra nhật ký Message Processor:

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

   2. Tìm kiếm để xem có lỗi 502 nào xảy ra trong một khoảng thời gian cụ thể (nếu vấn đề xảy ra trong quá khứ) hay có phản hồi nào vẫn gặp lỗi 502 hay không. Bạn có thể sử dụng chuỗi tìm kiếm sau:

      grep -ri "ZipException"
      

   3. Bạn sẽ thấy các dòng trong system.log tương tự như sau:

      Tình huống 1

      Trường hợp 1: Khi phản hồi API có tiêu đề 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
      

      Dòng java.util.zip.ZipException: Not in GZIP format trong thông báo lỗi ở trên cho biết tải trọng phản hồi không được gửi ở định dạng GZIP mặc dù Content-Encoding được chỉ định là gzip. Do đó, Apigee Edge sẽ gửi ngoại lệ và trả về mã trạng thái 502 kèm theo mã lỗi messaging.adaptors.http.flow.DecompressionFailureAtResponse cho các ứng dụng khách.

      Tình huống 2

      Tình huống 2: Khi phản hồi API có tiêu đề 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
      
      

      Các dòng java.util.zip.ZipException: incorrect header check và Caused by: java.util.zip.DataFormatException: incorrect header check trong thông báo lỗi ở trên cho biết tải trọng phản hồi không được gửi ở định dạng deflate và không khớp với phương thức mã hoá được chỉ định trong tiêu đề Content-Encoding của deflate. Do đó, Apigee Edge sẽ gửi ngoại lệ và trả về mã trạng thái 502 với mã lỗi messaging.adaptors.http.flow.DecompressionFailureAtResponse cho các ứng dụng khách.

Độ phân giải

1. Nếu không cần tải trọng phản hồi được nén trong quy trình proxy API trong Apigee Edge và trong máy chủ phụ trợ, thì đừng truyền tiêu đề Content-Encoding. Nếu cần nén tải trọng phản hồi, hãy chuyển sang bước 2.
2. Nếu cần nén tải trọng phản hồi, hãy đảm bảo rằng máy chủ phụ trợ luôn gửi những nội dung sau:
   • Bất kỳ mã hoá được hỗ trợ nào làm giá trị cho tiêu đề Content-Encoding trong phản hồi
   • Tải trọng phản hồi ở định dạng được hỗ trợ cho Apigee Edge khớp với định dạng mã hoá được chỉ định trong tiêu đề Content-Encoding
3. Trong ví dụ được thảo luận ở trên, tải trọng phản hồi ở định dạng ZIP nhưng tiêu đề phản hồi chỉ định Content-Encoding: gzip. Bạn có thể khắc phục vấn đề này bằng cách gửi tiêu đề phản hồi dưới dạng Content-Encoding: gzip và tải trọng phản hồi ở định dạng 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)>
   

Thông số kỹ thuật

Apigee Edge phản hồi bằng mã trạng thái 502 Bad Gateway với mã lỗi messaging.adaptors.http.flow.DecompressionFailureAtResponse theo các quy cách RFC sau:

Nếu bạn vẫn cần được Nhóm hỗ trợ Apigee trợ giúp, hãy xem phần Bạn phải thu thập thông tin chẩn đoán.

Phải thu thập thông tin chẩn đoán

Thu thập thông tin chẩn đoán sau đây, rồi liên hệ với Nhóm hỗ trợ Apigee Edge:

Nếu bạn là người dùng Đám mây công cộng, hãy cung cấp những thông tin sau:

• Tên tổ chức
• Tên môi trường
• Tên API Proxy
• Lệnh curl hoàn tất được dùng để tái tạo lỗi 502
• Tệp theo dõi cho các phản hồi của API

Nếu bạn là người dùng Đám mây riêng, hãy cung cấp những thông tin sau:

• Thông báo lỗi hoàn chỉnh được ghi nhận cho các phản hồi không thành công
• Tên môi trường
• Gói API Proxy
• Tệp theo dõi cho các phản hồi của API

• Nhật ký truy cập NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Trong đó: ORG, ENV và PORT# được thay thế bằng các giá trị thực tế.

• Nhật ký hệ thống của Trình xử lý tin nhắn /opt/apigee/var/log/edge-message-processor/logs/system.log