502 Bad Gateway - ResponseWithBody

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Triệu chứng

Ứng dụng khách sẽ nhận được mã trạng thái HTTP 502 Bad Gateway kèm theo lỗi mã protocol.http.ResponseWithBody làm phản hồi cho lệnh gọi API.

Thông báo lỗi

Ứng dụng sẽ nhận được mã phản hồi sau đây:

HTTP/1.1 502 Bad Gateway

Ngoài ra, bạn có thể nhận thấy một trong các thông báo lỗi sau:

{
   "fault":{
      "faultstring":"Received 204 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

{
   "fault":{
      "faultstring":"Received 205 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

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

Lỗi này xảy ra nếu phản hồi HTTP từ máy chủ phụ trợ đến Apigee Edge 204 No Content hoặc 205 Reset Content nhưng chứa phản hồi body và/hoặc một hoặc nhiều tiêu đề sau:

• Content-Length
• Content-Encoding
• Transfer-Encoding

Theo thông số kỹ thuật RFC 7231, mục 6.3.5: 204 Không có nội dung và RFC 7231, mục 6.3.6: 205 Đặt lại nội dung, dự kiến sẽ không có nội dung bổ sung phải được máy chủ gốc gửi dưới dạng một phần của nội dung tải trọng phản hồi có mã trạng thái 204 No Content hoặc 205 Reset Content. Tiêu đề phản hồi chẳng hạn như Content-Length, Content-Encoding hoặc Transfer-Encoding cho biết kích thước, loại hoặc định dạng của tải trọng phản hồi.

Do đó, Apigee Edge trả về mã trạng thái 502 Bad Gateway có mã lỗi protocol.http.ResponseWithBody cho máy khách theo các dòng sau trường hợp:

	Mã trạng thái từ máy chủ phụ trợ
Phản hồi từ máy chủ phụ trợ chứa	204 Không có nội dung	205 Đặt lại nội dung
Nội dung phản hồi	ERROR (LỖI)	ERROR (LỖI)
Tiêu đề Content-Length (được đặt thành khác 0)	ERROR (LỖI)	ERROR (LỖI)
Content-Encoding (được đặt thành hỗ trợ mã hoá trong Apigee Edge)	ERROR (LỖI)	KHÔNG CÓ LỖI
Transfer-Encoding	ERROR (LỖI)	ERROR (LỖI)

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

Nguyên nhân	Mô tả	Hướng dẫn khắc phục sự cố áp dụng cho
Nội dung phản hồi hoặc tiêu đề có phản hồi 204 từ máy chủ phụ trợ	Máy chủ phụ trợ sẽ gửi một 204 No Content hoặc 205 Reset Content phản hồi có nội dung phản hồi và/hoặc một hoặc nhiều tiêu đề Content-Type, Content-Encoding hoặc Transfer-Encoding.	Người dùng Edge công khai và riêng tư

Các bước chẩn đoán phổ biến

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: Nội dung phản hồi hoặc tiêu đề có phản hồi 204 từ máy chủ phụ trợ

Chẩn đoán

1. Xác định Mã lỗi và Nguồn lỗi cho lỗi phát hiện được bằng API Nhật ký giám sát, công cụ theo dõi hoặc nhật ký truy cập NGINX như được giải thích trong Các bước chẩn đoán thường gặp.
2. Nếu Mã lỗi là protocol.http.ResponseWithBody và Nguồn lỗi có giá trị target, thì mã này cho biết chương trình phụ trợ máy chủ đã phản hồi với trạng thái 204 No Content hoặc 205 Reset Content có nội dung phản hồi và/hoặc một trong các tiêu đề được đề cập trong Nguyên nhân có thể xảy ra.

3. Để xác thực xem máy chủ phụ trợ đã thực sự gửi nội dung tải trọng phản hồi và/hoặc một hoặc nhiều tiêu đề được đề cập trong Nguyên nhân có thể xảy ra, bạn có thể thực hiện các bước sau:

   1. Nếu bạn là người dùng Cloud Public và nếu bạn có thể gửi cùng một yêu cầu API cho máy chủ phụ trợ trực tiếp từ bất kỳ hệ thống nào của bạn.

   2. Nếu là người dùng Đám mây riêng tư, bạn có thể gửi cùng một yêu cầu API cho máy chủ phụ trợ trực tiếp từ một trong các Trình xử lý thư được liên kết với tổ chức và môi trường nơi phát hiện lỗi.

   3. Xem lại phản hồi nhận được từ máy chủ phụ trợ và xác minh rằng phản hồi đó có chứa mã nội dung tải trọng phản hồi và/hoặc một hoặc nhiều tiêu đề nêu trên. Nếu có, thì đó là nguyên nhân gây ra lỗi này.

      Mẫu số 1

      Mẫu số 1: Phản hồi 204 của máy chủ phụ trợ với tiêu đề Content-Encoding

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Encoding: gzip
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      Trong mẫu này, máy chủ phụ trợ đã phản hồi bằng Mã trạng thái 204 No Content và Content-Encoding: gzip

      Mẫu số 2

      Mẫu số 2: Phản hồi 204 của máy chủ phụ trợ với tiêu đề Content-Length

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Length: 48
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      Trong mẫu này, máy chủ phụ trợ đã phản hồi bằng Mã trạng thái 204 No Content và Content-Length: 48

      Mẫu số 3

      Mẫu số 3: Phản hồi 205 của máy chủ phụ trợ với nội dung phản hồi

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 205 Reset Content
      < Date: Sat, 31 Jul 2021 17:14:09 GMT
      < Content-Length: 12
      < Content-Type: text/plain; charset=utf-8
      <
      * Connection #0 to host X.X.X.X left intact
      This is a sample Response
      

      Trong mẫu này, máy chủ phụ trợ đã phản hồi bằng Mã trạng thái 205 Reset Content có nội dung phản hồi This is a sample Response.

   4. Trong tất cả ví dụ trên, máy chủ phụ trợ đã gửi 204 No Content hoặc Mã trạng thái 205 Reset Content cùng với nội dung phản hồi và/hoặc một trong các tiêu đề được đề cập trong Nguyên nhân có thể xảy ra.
   5. Do đó, Apigee Edge đã gửi mã trạng thái 502 Bad Gateway có mã lỗi protocol.http.ResponseWithBody.

Độ phân giải

Đảm bảo máy chủ phụ trợ luôn tuân thủ Thông số kỹ thuật RFC 7231, mục 6.3.6: 205 Đặt lại nội dung, khi gửi 204 No Content hoặc 205 Reset Content phản hồi với Apigee Edge. Tức là máy chủ phụ trợ KHÔNG ĐƯỢC gửi nội dung sau đây như một phần của 204 No Content hoặc 205 Reset Content phản hồi:

1. Nội dung tải trọng phản hồi
2. Và bất kỳ tiêu đề nào sau đây:
   1. Content-Length
   2. Content-Encoding
   3. Transfer-Encoding

Thông số kỹ thuật

Apigee Edge phản hồi bằng mã trạng thái 502 Bad Gateway và mã lỗi protocol.http.ResponseWithBody nếu máy chủ phụ trợ gửi 204 No Content hoặc 205 Reset Content phản hồi nhưng không tuân thủ các thông số kỹ thuật RFC sau đây:

Thông số kỹ thuật
RFC 7231, mục 6.3.5: 204 Không có nội dung
RFC 7231, mục 6.3.6: 205 Đặt lại nội dung

Các điểm chính cần lưu ý

Giải pháp được đề xuất là khắc phục sự cố máy chủ phụ trợ để gửi 204 No Content và mã trạng thái 205 Reset Content không có nội dung phản hồi và bất kỳ tiêu đề - Content-Length, Content-Encoding và Transfer-Encoding và tuân thủ thông số kỹ thuật RFC 7231, mục 6.3.5: 204 Không có nội dung và RFC 7231, mục 6.3.6: 205 Đặt lại nội dung.

Nếu bạn vẫn cần hỗ trợ từ Nhóm hỗ trợ Apigee, hãy truy cập vào 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 những thông tin chẩn đoán sau đây rồi liên hệ với Bộ phận hỗ trợ Apigee Edge:

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

• Tên tổ chức
• Tên môi trường
• Tên proxy API
• Hoàn tất lệnh curl dùng để tái hiện lỗi 502
• Tệp theo dõi cho các yêu cầu API

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

• Đã nhận thấy thông báo lỗi hoàn chỉnh đối với các yêu cầu không thực hiện được
• Tên môi trường
• Gói Proxy API
• Tệp theo dõi cho các yêu cầu API

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

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

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