502 Bad Gateway - TooBigBody

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 đượ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 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ể nhận 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 từ máy chủ đích/phụ trợ gửi tới Apigee Edge trong phản hồi HTTP lớn hơn giới hạn cho phép trong Apigee Edge.

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

Nguyên nhân	Nội dung mô tả	Hướng dẫn khắc phục sự cố áp dụng cho
Kích thước tải trọng phản hồi lớn hơn giới hạn cho phép	Kích thước tải trọng do máy chủ đích/máy chủ phụ trợ gửi trong phản hồi HTTP tới Apigee vượt quá giới hạn cho phép trong Apigee.	Người dùng Edge Public và Private Cloud
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	Kích thước tải trọng do máy chủ đích/phụ trợ gửi ở định dạng nén trong phản hồi HTTP cho Apigee vượt quá giới hạn cho phép khi được giải nén bằng Apigee.	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: Kích thước tải trọng của 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 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ư giải thích trong phần Các bước chẩn đoán phổ biến trong Tình huống #1.
2. Nếu Nguồn lỗi có giá trị target, thì tức là kích thước tải trọng phản hồi do máy chủ đích/phụ trợ gửi tới Apigee lớn hơn giới hạn được cho phép trong Apigee Edge.
3. Xác minh Kích thước tải trọng phản hồi như xác định trong bước 1.
   • Nếu kích thước tải trọng > 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 sẽ được truyền ở định dạng nén. Truy cập vào 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 10 MB bằng cách kiểm tra phản hồi thực tế qua 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ủ mục tiêu/phần phụ trợ, hãy chuyển đến mục 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ủ mục tiêu/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ợ qua 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ợ từ đó.
      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ợ qua một trong các Bộ 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 (Độ dài nội dung).
      4. Nếu bạn nhận thấy kích thước của tải trọng vượt quá giới hạn cho phép trong Apigee Edge, thì đó chính là nguyên nhân của 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) chính là nguyên nhân của lỗi này vì ứng dụng này vượt quá giới hạn cho phép trong Apigee Edge.

Độ phân giải

Tham khảo mục Độ phân giải.

Nguyên nhân: Kích thước tải trọng của 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, 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ì ứng dụng sẽ ngừng giải nén thêm và phản hồi lại ngay 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 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ư giải thích trong phần Các bước chẩn đoán phổ biến cho Tình huống 2.
2. Nếu Nguồn lỗi có giá trị target, thì tức là kích thước tải trọng phản hồi mà ứng dụng đích/phụ trợ gửi tới 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ư xác định trong bước 1.
   • Nếu kích thước tải trọng lớn hơn hạn mức cho phép là 10 MB, thì đó chính 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 sẽ đượ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 nén.
4. Bạn có thể xác thực xem phản hồi từ mục tiêu/phần phụ trợ được gửi ở định dạng nén và kích thước không nén có lớn hơn giới hạn cho phép hay không bằng một trong các phương thức sau:

   Trace

   Sử dụng công cụ Theo dõi:

   1. Nếu bạn đã thu thập được dấu vết của yêu cầu không thành công, hãy tham khảo các bước được nêu chi tiết trong bài viết 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 của ứng dụng có chứa tiêu đề Content-Encoding: gzip hay không
   2. Nếu giá trị của target.received.content.length nằm trong khoảng giới hạn cho phép là 10 MB và tiêu đề phản hồi target.received.content.length thì đó chính 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ủ mục tiêu/phần phụ trợ, hãy chuyển đến mục 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ủ mục tiêu/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 nhận thấy tiêu đề phản hồi Content-Encoding được đặt thành gzip và kích thước không nén của tải trọng vượt quá giới hạn được cho phép trong Apigee Edge, thì đó chính 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 sẽ đượ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 không nén testzippedfile là khoảng 15 MB.

   Nhật ký Trình xử lý thư

   Sử dụng nhật ký Trình xử lý thông báo:

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

   2. Kiểm tra nhật ký 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 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 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ư dưới đây (TotalRead và chunkCount có thể khác nhau tuỳ theo 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 xác định rằng tổng số byte đã đọc lớn hơn 10 MB, Bộ xử lý thông báo sẽ dừng và in dòng sau:

      Message is too large. TotalRead 10489856 chunkCount 2571

      Tức là 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

Các giới hạn

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

1. Nếu bạn là người dùng Cloud công khai, thì giới hạn tối đa cho kích thước tải trọng yêu cầu và phản hồi như được ghi trong tài liệu về Request/response size trong phần 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 đối với kích thước tải trọng yêu cầu và phản hồi (mặc dù bạn không nên áp dụng phương pháp này). 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 các hướng dẫn trong bài viết 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 với một giá trị mới trên Bộ xử lý thông báo.

1. Trên máy 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 rồi kiểm tra xem bạn đã thiết lập giá trị nào như đoạn mã dưới đây:

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

2. Kết quả mẫu từ lệnh trên như sau:

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

3. Trong kết quả ví dụ ở trên, hãy lưu ý rằng thuộc tính HTTPResponse.body.buffer.limit đã được thiết lập bằng giá trị 10m trong http.properties.

   Mã này cho biết giới hạn đối với kích thước tải trọng yêu cầu được định cấu hình trong Apigee dành cho đám mây riêng tư là 10 MB.

Nếu bạn vẫn cần Nhóm hỗ trợ Apigee hỗ trợ, hãy truy cập vào 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 hiện 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ủ mục tiêu/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 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 tổ chức
• Tên môi trường
• Gói Proxy API
• Tệp theo dõi cho các yêu cầu API không thành công
• Hoàn tất lệnh curl dùng để tái hiện lỗi 502
• Hoàn tất đầu ra của phản hồi từ máy chủ mục tiêu/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 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