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 400 Bad Request
với mã lỗi messaging.adaptors.http.flow.DecompressionFailureAtRequest
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 400 Bad Request
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 request", "detail":{ "errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtRequest" } } }
Các nguyên nhân có thể
Lỗi này chỉ xảy ra khi:
- Phương thức mã hoá được chỉ định trong tiêu đề yêu cầu HTTP
Content-Encoding
là hợp lệ và được Apigee Edge hỗ trợ, - Định dạng tải trọng mà ứng dụng gửi trong yêu cầu HTTP không khớp với định dạng mã hoá được chỉ định trong tiêu đề
Content-Encoding
NHƯNG
Nguyên nhân là do Apigee Edge không giải mã được tải trọng bằ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 mã hoá được chỉ định trong tiêu đề Content-Encoding
.
Dưới đây là một vài ví dụ về các giá trị Content-Encoding
được hỗ trợ và đánh giá của Apigee Edge về định dạng tải trọng trong những trường hợp đó:
Trường hợp | Mã hoá nội dung | Định dạng tải trọng dự kiến |
---|---|---|
Mã hoá đơn | gzip | Định dạng Xem phần Định dạng GZIP RFC1952. |
Mã hoá đơn | giảm âm | Định dạng này sử dụng cấu trúc |
Mã hoá nhiều lần | Mã hoá nhiều lần Ví dụ: trong trường hợp mã hoá được thực hiện hai lần, có thể là:
|
Nhiều phương thức mã hoá được áp dụng cho tải trọng theo thứ tự nhất định như khi xuất hiện trong tiêu đề. |
Các nguyên nhân có thể dẫn đến lỗi này như sau:
Nguyên nhân | Nội dung mô tả | Hướng dẫn khắc phục sự cố áp dụng cho |
---|---|---|
Định dạng tải trọng yêu cầu không khớp với mã hoá được chỉ định trong tiêu đề Content-Encoding | Định dạng của tải trọng yêu cầu do ứng dụng gửi không được mã hoá hoặc không khớp với phương thức mã hoá được chỉ định trong tiêu đề Content-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:
Giám sát API
Cách chẩn đoán lỗi bằng tính năng Giám sát API:
- Đăng nhập vào giao diện người dùng Apigee Edge với tư cách là một người dùng có vai trò thích hợp.
Chuyển sang tổ chức mà bạn muốn điều tra vấn đề.
- Chuyển đến trang Phân tích > Giám sát API > Điều tra.
- Chọn khung thời gian cụ thể mà bạn quan sát thấy lỗi.
- Đảm bảo rằng bộ lọc Proxy được đặt thành Tất cả.
- Vẽ Mã lỗi dựa trên Thời gian.
Chọn một ô có mã lỗi
messaging.adaptors.http.flow.DecompressionFailureAtRequest
như minh hoạ dưới đây:Thông tin về mã lỗi
messaging.adaptors.http.flow.DecompressionFailureAtRequest
hiển thị như sau:Nhấp vào Xem nhật ký và mở rộng hàng không thành công với lỗi
400
.- Trong cửa sổ Logs (Nhật ký), hãy lưu ý những thông tin sau:
- Mã trạng thái:
400
- Nguồn lỗi:
proxy
- Mã lỗi:
messaging.adaptors.http.flow.DecompressionFailureAtRequest
.
- Mã trạng thái:
- Nếu Nguồn lỗi có giá trị
proxy
, thì tức là định dạng tải trọng yêu cầu không khớp với phương thức mã hoá được hỗ trợ được chỉ định trong tiêu đềContent-Encoding
.
Công cụ theo dõi
Cách chẩn đoán lỗi bằng công cụ Theo dõi:
- Bật tính năng theo dõi phiên và:
- Chờ lỗi
400 Bad Request
xảy ra, hoặc - Nếu bạn có thể tái hiện vấn đề, hãy thực hiện lệnh gọi API và tái tạo
400 Bad Request
.
- Chờ lỗi
Đảm bảo bạn đã bật tuỳ chọn Show all FlowInfos (Hiện tất cả thông tin luồng):
- Chọn một trong các yêu cầu không thành công rồi kiểm tra dấu vết.
- Di chuyển qua các giai đoạn theo dõi và xác định vị trí xảy ra lỗi.
Thường thì bạn sẽ thấy lỗi trong quy trình ngay sau giai đoạn Yêu cầu nhận được từ ứng dụng, như minh hoạ dưới đây:
-
Lưu ý giá trị của các thuộc tính trong dấu vết:
- lỗi:
Decompression failure at request
- error.class:
com.apigee.rest.framework.BadRequestException
- error.cause:
Not in GZIP format
error.cause cho biết rằng tải trọng yêu cầu KHÔNG ở định dạng GZIP. Điều này có nghĩa là Apigee Edge dự kiến rằng tải trọng yêu cầu phải ở định dạng GZIP vì định dạng này đã được chỉ định trong tiêu đề
Content-Encoding
. - lỗi:
Xác định giá trị của tiêu đề yêu cầu
Content-Encoding
. Để làm được điều này, hãy chuyển đến giai đoạn Đã nhận được yêu cầu từ khách hàng như sau:Lưu ý rằng giá trị của tiêu đề yêu cầu
Content-Encoding
thực sự làgzip
.Dấu vết mẫu ở trên cho thấy phương thức mã hoá được chỉ định trong tiêu đề của yêu cầu
Content-Encoding
làgzip
. Tuy nhiên, tải trọng yêu cầu không ở định dạng GZIP. Do đó, Apigee không thể giải nén tải trọng bằng gzip và trả về lỗiDecompression failure at request
.- Ghi lại mã trạng thái và thông báo lỗi do Apigee Edge trả về bằng cách điều hướng
giai đoạn Phản hồi gửi cho ứng dụng trong dấu vết như minh hoạ dưới đây:
Hãy lưu ý những thông tin chi tiết sau trong dấu vết:
- Mã trạng thái:
400 Bad Request
. - Nội dung lỗi:
{"fault":{"faultstring":"Decompression failure at request","detail":{"errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtRequest"}}}
- Mã trạng thái:
Chuyển đến giai đoạn AX (Dữ liệu phân tích được ghi lại) trong dấu vết rồi nhấp vào đó.
- Di chuyển xuống mục Giai đoạn chi tiết, Tiêu đề lỗi (Error Headers) rồi xác định giá trị của X-Apigee-fault-code và X-Apigee-fault-source như sau:
- Bạn sẽ thấy các giá trị của X-Apigee-fault-code và X-Apigee-fault-source dưới dạng
messaging.adaptors.http.flow.DecompressionFailureAtRequest
vàpolicy
, cho biết rằng định dạng tải trọng yêu cầu không khớp với phương thức mã hoá được chỉ định trong tiêu đềContent-Encoding
.Tiêu đề phản hồi Giá trị X-Apigee-fault-code messaging.adaptors.http.flow.DecompressionFailureAtRequest
X-Apigee-fault-source policy
NGINX
Cách chẩn đoán lỗi bằng nhật ký truy cập NGINX:
- Nếu là người dùng Đám mây riêng tư, bạn có thể dùng nhật ký truy cập NGINX để xác định thông tin chính về lỗi HTTP
400
. Kiểm tra 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 bằng giá trị thực tế.
- Tìm kiếm xem có lỗi
400
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ới400
hay không. Nếu bạn tìm thấy bất kỳ lỗi
400
nào có X-Apigee-fault-code khớp với giá trị củamessaging.adaptors.http.flow.DecompressionFailureAtRequest
, thì hãy xác định giá trị của X-Apigee-fault-source.Ví dụ về lỗi 400 trong nhật ký truy cập NGINX:
Mục mẫu ở trên từ nhật ký truy cập NGINX có các giá trị sau đây cho X-Apigee-fault-code và X-Apigee-fault-code
Tiêu đề phản hồi Giá trị X-Apigee-fault-code messaging.adaptors.http.flow.DecompressionFailureAtRequest
X-Apigee-fault-source policy
Nguyên nhân: Định dạng tải trọng yêu cầu không khớp với mã hoá được chỉ định trong tiêu đề Content-Encoding
Theo mặc định, Apigee Edge luôn giải nén tải trọng nếu tiêu đề của yêu cầu Content-Encoding
chứa một
phương thức mã hoá được hỗ trợ hợp lệ. Do đó, định dạng của tải trọng yêu cầu phải khớp với định dạng mã hoá được chỉ định trong tiêu đề yêu cầu Content-Encoding
.
Nếu không khớp, bạn sẽ gặp lỗi này.
Chẩn đoán
- Xác định Mã lỗi và Nguồn lỗi cho lỗi quan sát đượ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.
- Nếu Mã lỗi là
messaging.adaptors.http.flow.DecompressionFailureAtRequest
và Nguồn lỗi có giá trịpolicy
hoặcproxy
, thì điều này cho biết rằng yêu cầu do ứng dụng gửi có tải trọng không khớp với mã hoá được hỗ trợ được chỉ định trong tiêu đề yêu cầuContent-Encoding
. Bạn có thể xác định trường hợp không khớp trong yêu cầu 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:
-
Nếu bạn có quyền truy cập vào thông báo lỗi đầy đủ mà Apigee nhận được từ Apigee, hãy tham khảo
faultstring
.Mẫu thông báo lỗi:
"faultstring":"Decompression failure at request"
- Trong thông báo lỗi ở trên, thông báo lỗi sẽ hiển thị
"Decompression failure at request"
, ngụ ý rằng không thể giải nén yêu cầu 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 Dấu vết:
- Xác định giá trị của tiêu đề yêu cầu Content-Encoding và thuộc tính error.error bằng cách sử dụng Trace như giải thích trong phần Các bước chẩn đoán phổ biến.
Các giá trị của dấu vết mẫu như sau:
- Mã hoá nội dung:
gzip
- error.cause:
Not in GZIP format
Giá trị trong tiêu đề yêu cầu Content-Encoding là gzip; tuy nhiên, tải trọng yêu cầu không ở định dạng GZIP (như được chỉ định bởi error.ers). Do đó, Apigee Edge sẽ phản hồi bằng
400 Bad Request
và mã lỗimessaging.adaptors.http.flow.DecompressionFailureAtRequest
.- Mã hoá nội dung:
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ế do ứng dụng đưa ra, hãy thực hiện các bước sau:
- Xác định giá trị được chuyển đến tiêu đề của yêu cầu
Content-Encoding
. - Xác định định dạng của tải trọng được gửi trong yêu cầu.
Nếu giá trị của tiêu đề
Content-Encoding
có trong danh sách phương thức mã hoá được hỗ trợ nhưng định dạng của tải trọng yêu cầu không khớp với phương thức mã hoá được chỉ định trong tiêu đềContent-Encoding
, thì đó chính là nguyên nhân của sự cố.Yêu cầu mẫu:
curl -v "http://HOSTALIAS/v1/testgzip"
-H "Content-Encoding: gzip"
-X POST -d @request_payload.zipYêu cầu mẫu ở trên sẽ gửi giá trị
gzip
đến tiêu đềContent-Encoding
. Đây là một phương thức mã hoá được hỗ trợ trong Apigee Edge. Tuy nhiên, tải trọng yêu cầurequest_payload.zip
ở định dạng ZIP. Do đó, yêu cầu này sẽ không thành công với mã trạng thái400 Bad Request
và mã lỗi:messaging.adaptors.http.flow.DecompressionFailureAtRequest
.
Nhật ký Trình xử lý thư
Cách xác thực bằng nhật ký Trình xử lý thông báo:
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
400
.- Xác định mã thông báo của yêu cầu không thành công 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.
Tìm kiếm mã nhận dạng thư trong nhật ký Trình xử lý thư:
/opt/apigee/var/log/edge-message-processor/logs/system.log
Bạn sẽ thấy một trong các trường hợp ngoại lệ sau:
Tình huống 1
Trường hợp 1: Khi yêu cầu API có tiêu đề Content-Encoding: gzip
2021-07-28 10:21:16,861 NIOThread@0 ERROR HTTP.SERVER - HTTPServer$Context.onInputException() : Message id:rt-57-1 SSLClientChannel[Accepted: Remote:192.168.199.8:8443 Local:192.168.80.234:44284]@28469 useCount=1 bytesRead=0 bytesWritten=28764 age=2739893ms lastIO=0ms isOpen=true.onExceptionRead exception: {} java.util.zip.ZipException: Not in GZIP format 2021-07-28 10:21:16,862 NIOThread@0 ERROR ADAPTORS.HTTP.FLOW - AbstractRequestListener.onException() : Request:POST, uri:/test, message Id:rt-57-1, exception:java.util.zip.ZipException: Not in GZIP format, context:Context@71ea5ac input=ClientInputChannel(SSLClientChannel[Accepted: Remote:192.168.199.8:8443 Local:192.168.80.234:44284]@28469 useCount=1 bytesRead=0 bytesWritten=28764 age=2739894ms lastIO=0ms isOpen=true) 2021-07-28 10:21:16,862 NIOThread@0 INFO HTTP.SERVICE - ExceptionHandler.handleException() : Exception
java.util.zip.ZipException: Not in GZIP format
occurred while writing to channel null 2021-07-28 10:21:16,863 NIOThread@0 INFO HTTP.SERVICE - ExceptionHandler.handleException() : Exception trace: java.util.zip.ZipException: Not in GZIP formatDòng
java.util.zip.ZipException: Not in GZIP format
trong thông báo lỗi ở trên cho biết rằng tải trọng yêu cầu không được gửi ở định dạng GZIP mặc dùContent-Encoding
được chỉ định là tệp gzip. Do đó, Apigee Edge sẽ gửi trường hợp ngoại lệ và trả về một mã trạng thái400
có mã lỗimessaging.adaptors.http.flow.DecompressionFailureAtRequest
cho các ứng dụng khách.Tình huống #2
Trường hợp 2: Khi yêu cầu API có tiêu đề Content-Encoding: deflate
2021-07-28 15:26:31,893 NIOThread@1 ERROR HTTP.SERVER - HTTPServer$Context.onInputException() : Message id:rt-47875-1 SSLClientChannel[Accepted: Remote:192.168.199.8:8443 Local:192.168.81.72:45954]@29276 useCount=1 bytesRead=0 bytesWritten=37230 age=3498856ms lastIO=1ms isOpen=true.onExceptionRead exception: {}
java.util.zip.ZipException: incorrect header check
….Caused by: java.util.zip.DataFormatException: incorrect header check
.. 2021-07-28 15:26:31,894 NIOThread@1 ERROR ADAPTORS.HTTP.FLOW - AbstractRequestListener.onException() : Request:POST, uri:/test, message Id:rrt-47875-1, exception:java.util.zip.ZipException: incorrect header check, context:Context@69b3ac45 input=ClientInputChannel(SSLClientChannel[Accepted: Remote:192.168.199.8:8443 Local:192.168.81.72:45954]@29276 useCount=1 byt esRead=0 bytesWritten=37230 age=3498856ms lastIO=1ms isOpen=true)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 rằng tải trọng yêu cầu không được gửi ở định dạng giảm phát và không khớp với phương thức mã hoá được chỉ định trong tiêu đềContent-Encoding
giảm tốc. Do đó, Apigee Edge sẽ gửi trường hợp ngoại lệ này và trả về một mã trạng thái400
có mã lỗimessaging.adaptors.http.flow.DecompressionFailureAtRequest
cho các ứng dụng khách.
-
Độ phân giải
- Nếu không cần tải trọng yêu cầu nén trong quy trình proxy API trong Apigee Edge và trong máy chủ phụ trợ, thì bạn không cần truyền tiêu đề
Content-Encoding
. Nếu cần phải nén tải trọng yêu cầu, hãy chuyển sang bước 2. - Đảm bảo rằng ứng dụng khách luôn gửi các nội dung sau:
- Bất kỳ
phương thức mã hoá được hỗ trợ nào làm giá trị cho tiêu đề
Content-Encoding
trong yêu cầu - Tải trọng yêu cầu ở đị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
- Bất kỳ
phương thức mã hoá được hỗ trợ nào làm giá trị cho tiêu đề
- Trong ví dụ thảo luận ở trên, tải trọng yêu cầu ở định dạng ZIP nhưng tiêu đề yêu cầu 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 đề yêu cầu dưới dạngContent-Encoding: gzip
và tải trọng yêu cầu cũng ở định dạnggzip
:curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.gz
Thông số kỹ thuật
Apigee Edge phản hồi bằng mã trạng thái 400 Bad Request
kèm mã lỗi messaging.adaptors.http.flow.DecompressionFailureAtRequest
theo các thông số RFC sau đây:
Thông số kỹ thuật |
---|
RFC 7231, mục 6.5.1 |
RFC 7231, mục 3.1.2.2 |
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 tạo lỗi400
- 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