502 Bad Gateway - TooBigBody

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 protocol.http.TooBigBody làm 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 thông báo lỗi sau:

{
   "fault":{
      "faultstring":"Body buffer overflow",
      "detail":{
         "errorcode":"protocol.http.TooBigBody"
      }
   }
}

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

Lỗi này xảy ra nếu kích thước tải trọng do máy chủ đích/phụ trợ gửi đến Apigee Edge trong phản hồi HTTP lớn hơn giới hạn cho phép trong Apigee Edge.

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: Kích thước tải trọng phản hồi lớn hơn giới hạn cho phép

Chẩn đoán

1. Xác định Mã lỗi, Nguồn lỗi và Kích thước tải trọng phản hồ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 Các bước chẩn đoán thường gặp với Tình huống 1.
2. Nếu Nguồn lỗi có giá trị target, thì điều này cho biết kích thước tải trọng phản hồi do máy chủ đích/phụ trợ gửi đến Apigee lớn hơn giới hạn cho phép trong Apigee Edge.
3. Xác minh Kích thước tải trọng phản hồi như được xác định ở bước 1.
   • Nếu kích thước tải trọng lớn hơn giới hạn cho phép là 10 MB, thì đó là nguyên nhân gây ra lỗi.
   • Nếu kích thước tải trọng ~ 10 MB (giới hạn cho phép), thì có thể tải trọng phản hồi được truyền ở định dạng nén. Chuyển đến Nguyên nhân: Kích thước tải trọng phản hồi vượt quá giới hạn cho phép sau khi giải nén.
4. Xác thực rằng kích thước tải trọng phản hồi thực sự lớn hơn giới hạn cho phép là 10 MB bằng cách kiểm tra phản hồi thực tế theo các bước sau:
   1. Nếu bạn không có quyền truy cập vào yêu cầu thực tế được gửi đến máy chủ đích/phụ trợ, hãy chuyển đến phần Giải pháp.
   2. Nếu bạn có quyền truy cập vào yêu cầu thực tế được gửi đến 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 cộng/Đá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. Xác minh kích thước của tải trọng được truyền trong phản hồi bằng cách kiểm tra tiêu đề Content-Length.
      4. Nếu bạn nhận thấy kích thước của tải trọng lớn hơn giới hạn cho phép trong Apigee Edge, thì đó là nguyên nhân gây ra vấn đề.

   Phản hồi mẫu từ máy chủ phụ trợ:

   curl -v https://BACKENDSERVER-HOSTNAME/testfile
   

   * About to connect() to 10.14.0.10 port 9000 (#0)
   *   Trying 10.14.0.10...
   * Connected to 10.14.0.10 (10.148.0.10) port 9000 (#0)
   > GET /testfile HTTP/1.1
   > User-Agent: curl/7.29.0
   > Host: 10.14.0.10:9000
   > Accept: */*
   >
   < HTTP/1.1 200 OK
   < Accept-Ranges: bytes
   < Content-Length: 11534336
   < Content-Type: application/octet-stream
   < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
   < Date: Wed, 30 Jun 2021 09:22:41 GMT
   <
   ----snipped----
   <Response Body>

   Trong ví dụ trên, bạn có thể thấy Content-Length: 11534336 (which is ~11 MB) là nguyên nhân gây ra lỗi này vì nó vượt quá giới hạn cho phép trong Apigee Edge.

Độ phân giải

Hãy tham khảo phần Độ phân giải.

Nguyên nhân: Kích thước tải trọng phản hồi vượt quá giới hạn cho phép sau khi giải nén

Nếu tải trọng phản hồi được gửi ở định dạng nén và tiêu đề phản hồi Content-Encoding được đặt thành gzip, , thì Apigee sẽ giải nén tải trọng phản hồi. Trong quá trình giải nén, nếu Apigee nhận thấy kích thước của tải trọng lớn hơn giới hạn cho phép trong Apigee Edge, thì Apigee sẽ dừng giải nén thêm và phản hồi ngay lập tức bằng 502 Bad Gateway và mã lỗi protocol.http.TooBigBody.

Chẩn đoán

1. Xác định Mã lỗi,Nguồn lỗi và Kích thước tải trọng phản hồ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 Các bước chẩn đoán thường gặp với Tình huống 2.
2. Nếu Nguồn lỗi có giá trị target, thì điều này cho biết kích thước tải trọng phản hồi do ứng dụng đích/phụ trợ gửi đến Apigee lớn hơn giới hạn cho phép trong Apigee Edge.
3. Xác minh Kích thước tải trọng phản hồi như được xác định ở bước 1.
   • Nếu kích thước tải trọng lớn hơn giới hạn cho phép là 10 MB, thì đó là nguyên nhân gây ra lỗi.
   • Nếu kích thước tải trọng ~ 10 MB, thì có thể tải trọng phản hồi được truyền ở định dạng nén. Trong trường hợp này, hãy kiểm tra kích thước chưa nén của tải trọng phản hồi được nén.
4. Bạn có thể xác thực xem phản hồi từ đích đến/phụ trợ có được gửi ở định dạng nén hay không và kích thước chưa nén lớn hơn giới hạn cho phép bằng một trong các phương thức sau:

   Trace

   Cách sử dụng công cụ Dấu vết:

   1. Nếu bạn đã ghi lại dấu vết cho yêu cầu không thành công, hãy tham khảo các bước được trình bày chi tiết trong phần Dấu vết và
      1. Xác định giá trị của target.received.content.length
      2. Xác minh xem yêu cầu từ máy khách có chứa tiêu đề Content-Encoding: gzip hay không
   2. Nếu giá trị của target.received.content.length gần với giới hạn cho phép là 10 MB và tiêu đề phản hồi Content-Encoding: gzip, thì đó là nguyên nhân gây ra lỗi này.

   Yêu cầu thực tế

   Sử dụng yêu cầu thực tế:

   1. Nếu bạn không có quyền truy cập vào yêu cầu thực tế được gửi đến máy chủ đích/phụ trợ, hãy chuyển đến phần Giải pháp.
   2. Nếu bạn có quyền truy cập vào yêu cầu thực tế được gửi đến máy chủ đích/phụ trợ, hãy thực hiện các bước sau:
      1. Xác minh kích thước của tải trọng được truyền trong phản hồi cùng với tiêu đề Content-Encoding được gửi trong phản hồi.
      2. Nếu bạn thấy tiêu đề phản hồi Content-Encoding được đặt thành gzip và kích thước chưa nén của tải trọng lớn hơn giới hạn cho phép trong Apigee Edge, thì đó là nguyên nhân gây ra lỗi này.

         Phản hồi mẫu nhận được từ máy chủ phụ trợ:

         curl -v https://BACKENDSERVER-HOSTNAME/testzippedfile.gz
         

         * About to connect() to 10.1.0.10 port 9000 (#0)
         *   Trying 10.1.0.10...
         * Connected to 10.1.0.10 (10.1.0.10) port 9000 (#0)
         > GET /testzippedfile.gz HTTP/1.1
         > User-Agent: curl/7.29.0
         > Host: 10.1.0.10:9000
         > Accept: */*
         >
         < HTTP/1.1 200 OK
         < Accept-Ranges: bytes
         < Content-Encoding: gzip
         < Content-Type: application/x-gzip
         < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
         < Testheader: test
         < Date: Wed, 07 Jul 2021 10:14:16 GMT
         < Transfer-Encoding: chunked
         <
         ----snipped----
         <Response Body>

         Trong trường hợp trên, tiêu đề Content-Encoding: gzip được gửi và kích thước của tệp testzippedfile.gz trong phản hồi nhỏ hơn giới hạn, tuy nhiên kích thước của tệp chưa nén testzippedfile là khoảng 15 MB.

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

   Sử dụng nhật ký Message Processor:

   1. 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.

   2. Kiểm tra nhật ký của Trình xử lý thư

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

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

      grep -ri "chunkCount"
      

      grep -ri "BadGateway: Body buffer overflow"
      

   4. Bạn sẽ thấy các dòng từ system.log tương tự như hình bên dưới (TotalRead và chunkCount có thể khác trong trường hợp của bạn):

      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.SERVICE -
      TrackingInputChannel.checkMessageBodyTooLarge() : Message is too large.
      TotalRead 10489856 chunkCount 2571
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :
      ClientInputChannel(ClientChannel[Connected:
      Remote:10.148.0.10:9000 Local:10.148.0.9:42240]@9155
      useCount=1 bytesRead=0 bytesWritten=182 age=23ms  lastIO=0ms
      isOpen=true).onExceptionRead exception: {}
      com.apigee.errors.http.server.BadGateway: Body buffer overflow
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR
      ADAPTORS.HTTP.FLOW - AbstractResponseListener.onException() :
      AbstractResponseListener.onError(HTTPResponse@77cbd7c4,
      Body buffer overflow)

   5. Trong quá trình giải nén, ngay khi Trình xử lý thông báo xác định tổng số byte đã đọc là > 10 MB, thì Trình xử lý thông báo sẽ dừng và in dòng sau:

      Message is too large. TotalRead 10489856 chunkCount 2571

      Điều này có nghĩa là Response Payload Size (Kích thước tải trọng phản hồi) lớn hơn 10 MB và Apigee sẽ gửi lỗi khi kích thước bắt đầu vượt quá giới hạn 10 MB với mã lỗi là protocol.http.TooBigBody

Độ phân giải

Giới hạn

Apigee yêu cầu ứng dụng khách và máy chủ phụ trợ không gửi kích thước tải trọng lớn hơn giới hạn cho phép như được ghi lại cho Request/response size trong Giới hạn của Apigee Edge.

1. Nếu bạn là người dùng Đám mây công cộng, thì giới hạn tối đa cho kích thước tải trọng của yêu cầu và phản hồi sẽ như được ghi lại cho Request/response size trong Giới hạn của Apigee Edge.
2. Nếu là người dùng Đám mây riêng tư , thì có thể bạn đã sửa đổi giới hạn tối đa mặc định cho kích thước tải trọng của yêu cầu và phản hồi (mặc dù đây không phải là cách nên làm). Bạn có thể xác định giới hạn kích thước tải trọng tối đa của yêu cầu bằng cách làm theo hướng dẫn trong phần Cách kiểm tra giới hạn hiện tại.

Cách kiểm tra hạn mức hiện tại

Phần này giải thích cách xác minh rằng thuộc tính HTTPResponse.body.buffer.limit đã được cập nhật bằng một giá trị mới trên Trình xử lý thông báo.

1. Trên máy Message Processor (Bộ xử lý thông báo), hãy tìm thuộc tính HTTPResponse.body.buffer.limit trong thư mục /opt/apigee/edge-message- processor/conf và kiểm tra xem giá trị nào đã được đặt như minh hoạ bên dưới:

   grep -ri "HTTPResponse.body.buffer.limit" /opt/apigee/edge-message-processor/conf
   

2. Sau đây là kết quả mẫu của lệnh trên:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.body.buffer.limit=10m

3. Trong đầu ra mẫu ở trên, hãy lưu ý rằng thuộc tính HTTPResponse.body.buffer.limit đã được đặt với giá trị 10m trong http.properties.

   Điều này cho thấy giới hạn kích thước tải trọng yêu cầu được định cấu hình trong Apigee cho Private Cloud là 10 MB.

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 chỉnh dùng để tái tạo lỗi 502
• Tệp theo dõi cho các yêu cầu API
• Hoàn tất đầu ra của phản hồi từ máy chủ đích/phụ trợ cùng với kích thước của tải trọng

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 yêu cầu không thành công
• Tên tổ chức
• Tên môi trường
• Gói API Proxy
• Tệp theo dõi cho các yêu cầu API không thành công
• Lệnh curl hoàn chỉnh dùng để tái tạo lỗi 502
• Hoàn tất đầu ra của phản hồi từ máy chủ đích/phụ trợ cùng với kích thước của tải trọng

• 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