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 sẽ nhận một mã trạng thái HTTP của 502 Bad Gateway với mã lỗi protocol.http.ResponseWithBody làm phản hồi cho 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 đây:

HTTP/1.1 502 Bad Gateway

Ngoài ra, bạn có thể 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ợ cho Apigee Edge là 204 No Content hoặc 205 Reset Content nhưng có chứa nội dung phản hồi 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 máy chủ gốc sẽ không gửi nội dung bổ sung nào trong 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. Các tiêu đề phản hồi 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 sẽ trả về một mã trạng thái 502 Bad Gateway có mã lỗi protocol.http.ResponseWithBody cho ứng dụng trong các trường hợp sau:

	Mã trạng thái từ máy chủ phụ trợ
Phản hồi từ máy chủ phụ trợ có 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)
Content-Length tiêu đề (đã đặt thành khác 0)	ERROR (LỖI)	ERROR (LỖI)
Content-Encoding (được đặt thành phương thức mã hoá được hỗ trợ trong Apigee Edge)	ERROR (LỖI)	KHÔNG CÓ LỖI
Transfer-Encoding	ERROR (LỖI)	ERROR (LỖI)

Dưới đây là một số nguyên nhân có thể gây ra lỗi này:

Nguyên nhân	Nội dung 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ợ gửi phản hồi 204 No Content hoặc 205 Reset Content kèm theo 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 Public và Private Cloud

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 đề 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 công cụ Giám sát API, Công cụ theo dõi hoặc nhật ký truy cập NGINX như 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à protocol.http.ResponseWithBody và Nguồn lỗi có giá trị target, thì tức là máy chủ phụ trợ đã phản hồi bằng mã trạng thái 204 No Content hoặc 205 Reset Content, kèm theo nội dung phản hồi và/hoặc một trong các tiêu đề nêu trong phần 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 hay chưa và/hoặc một hay nhiều tiêu đề được đề cập trong phần 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 công cộng và bạn có thể gửi cùng một yêu cầu API tới máy chủ phụ trợ ngay từ bất kỳ hệ thống nào của mình.

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

   3. Xem xét nội dung phản hồi nhận được từ máy chủ phụ trợ và xác minh rằng nội dung phản hồi đó có chứa một 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ì đó chính là nguyên nhân gây ra lỗi này.

      Mẫu số 1

      Mẫu 1: Phản hồi của máy chủ phụ trợ 204 với tiêu đề mã hoá nội dung

      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 của máy chủ phụ trợ 204 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 của máy chủ phụ trợ 205 có 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ả các ví dụ trên, máy chủ phụ trợ đã gửi mã trạng thái 204 No Content hoặc 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 phần 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 rằng 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 phản hồi 204 No Content hoặc 205 Reset Content cho Apigee Edge. Tức là máy chủ phụ trợ KHÔNG ĐƯỢC gửi những nội dung sau đây trong phản hồi 204 No Content hoặc 205 Reset Content:

1. Nội dung tải trọng phản hồi
2. Đồng thời, 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 sẽ 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 phản hồi 204 No Content hoặc 205 Reset Content 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 đề xuất là sửa máy chủ phụ trợ để gửi mã trạng thái 204 No Content và 205 Reset Content mà không có nội dung phản hồi cũng như bất kỳ tiêu đề nào – Content-Length, Content-Encoding và Transfer-Encoding, đồng thời tuân thủ các thông số kỹ thuật RFC 7231, phần 6.3.5: 204 Không có nội dung và RFC 7231, phần 6.3.6: 205 Đặt lại nội dung.

Nếu bạn vẫn cần Nhóm hỗ trợ Apigee hỗ trợ, hãy truy cập trang 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, sau đó liên hệ với Bộ phận hỗ trợ API Apigee:

Nếu bạn là người dùng Public Cloud, 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 tạo 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 những thông tin sau:

• Đã phát hiệ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ành công
• 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

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

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