502 Bad Gateway - Phản hồi 405 không có tiêu đề Allow

Giám sát API

Cách chẩn đoán lỗi bằng tính năng Giám sát API:

1. Đăng nhập vào Giao diện người dùng Edge với tư cách là người dùng có vai trò thích hợp.

2. Chuyển sang tổ chức mà bạn muốn điều tra vấn đề.

   
3. Chuyển đến trang Phân tích > Giám sát API > Điều tra.
4. Chọn khung thời gian cụ thể mà bạn quan sát thấy lỗi.

5. Vẽ Mã lỗi dựa trên Thời gian.

6. Chọn một ô có mã lỗi protocol.http.Response405WithoutAllowHeader như minh hoạ dưới đây:

   

7. Thông tin về mã lỗi protocol.http.Response405WithoutAllowHeader xuất hiện như sau:

   

8. Nhấp vào Xem nhật ký rồi mở rộng một trong các yêu cầu không thành công để xem thêm thông tin.

   
9. Trong cửa sổ Logs (Nhật ký), hãy lưu ý những thông tin sau:
   • Mã trạng thái: 502
   • Nguồn lỗi: target
   • Mã lỗi: protocol.http.Response405WithoutAllowHeader.
10. Nếu Nguồn lỗi là target và Mã lỗi là protocol.http.Response405WithoutAllowHeader, thì điều đó cho biết máy chủ phụ trợ đã phản hồi bằng mã trạng thái 405 Method Not Allowed mà không có tiêu đề Allow.

Công cụ theo dõi

Cách chẩn đoán lỗi bằng công cụ Theo dõi:

1. Bật phiên theo dõi và một trong hai tùy chọn sau:
   • Chờ lỗi 502 Bad Gateway xảy ra, hoặc
   • Nếu bạn có thể tái tạo vấn đề, hãy thực hiện lệnh gọi API để tái hiện vấn đề đó – lỗi 502 Bad Gateway

2. Đảm bảo bạn đã bật tuỳ chọn Show all FlowInfos (Hiện tất cả thông tin luồng):

   
3. 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.
4. Di chuyển qua các giai đoạn trong quá trình theo dõi và xác định vị trí xảy ra lỗi.

5. Bạn thường sẽ thấy lỗi này trong quy trình sau giai đoạn Request sent to target server (Yêu cầu gửi đến máy chủ mục tiêu) như minh hoạ dưới đây:

   

6. Ghi lại giá trị của lỗi trong dấu vết.

   Dấu vết mẫu ở trên cho thấy lỗi là Received 405 Response without Allow Header. Vì lỗi được Apigee báo cáo sau khi yêu cầu được gửi đến máy chủ phụ trợ, nên lỗi này cho biết máy chủ phụ trợ đã gửi mã trạng thái phản hồi 405 không có tiêu đề Allow.

7. Chuyển đến Giai đoạn AX (Dữ liệu phân tích đã ghi lại) trong dấu vết rồi nhấp vào đó.

8. Di chuyển xuống mục Error/ Response Headers (Tiêu đề lỗi/phản hồi) trong bảng Giai đoạn chi tiết rồi xác định giá trị của X-Apigee-fault-code và X-Apigee-fault-source như bên dưới:

   
9. Bạn sẽ thấy các giá trị của X-Apigee-fault-code và X-Apigee-fault-source tương ứng là protocol.http.Response405WithoutAllowHeader và target, cho biết lỗi này xảy ra vì phần phụ trợ đã gửi mã trạng thái phản hồi 405 mà không có tiêu đề Allow.

   Tiêu đề phản hồi	Giá trị
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

NGINX

Cách chẩn đoán lỗi bằng nhật ký truy cập NGINX:

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

2. Kiểm tra nhật ký truy cập NGINX:

   /opt/apigee/var/log/edge-router/nginx/ORG~ORG.PORT#_access_log
   

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

3. Tìm kiếm xem có lỗi 502 nào với mã lỗi protocol.http.Response405WithoutAllowHeader 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.

4. Nếu bạn tìm thấy bất kỳ lỗi 502 nào trong đó X-Apigee-fault-code khớp với giá trị của protocol.http.Response405WithoutAllowHeader, thì hãy xác định giá trị của X-Apigee-fault-code

   Ví dụ về lỗi 502 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 cho X-Apigee- fault-code và X-Apigee-fault-source:

   Tiêu đề phản hồi	Giá trị
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

Máy chủ phụ trợ

Lựa chọn 1: Khắc phục Máy chủ phụ trợ để gửi mã trạng thái 405 có tiêu đề Cho phép:

1. Đảm bảo máy chủ phụ trợ luôn tuân thủ thông số kỹ thuật RFC 7231, mục 6.5.5: 405 Phương pháp không được phép và gửi kèm mã trạng thái 405 bằng cách thêm danh sách các phương thức được phép vào tiêu đề Allow như minh hoạ dưới đây:

   Allow: HTTP_METHODS
   

2. Ví dụ: nếu máy chủ phụ trợ của bạn cho phép các phương thức GET, POST và HEAD, thì bạn cần đảm bảo rằng tiêu đề Allow chứa các phương thức đó như sau:

   Allow: GET, POST, HEAD
   

Xử lý lỗi

Lựa chọn 2: Sử dụng tính năng Xử lý lỗi để gửi mã trạng thái 405 có tiêu đề Cho phép từ proxy API của bạn:

Nếu máy chủ phụ trợ trả về mã trạng thái 405 mà không có tiêu đề Allow, thì bạn có thể dùng phương thức xử lý lỗi để phản hồi lại bằng mã trạng thái 405 và tiêu đề Allow qua proxy API như sau:

1. Tạo một chính sách như Chính sách assignMessage hoặc chính sách RaiseFault và đặt mã trạng thái thành 405 có tiêu đề Allow và thông báo tuỳ chỉnh.

   Chính sách AccessMessage mẫu để gửi 405 có tiêu đề Cho phép:

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-405WithAllowHeader">
       <DisplayName>AM-405WithAllowHeader</DisplayName>
       <Set>
           <Payload contentType="application/json">{"Specified method is not allowed. Please use one of the methods mentioned in the Allow header."}</Payload>
           <StatusCode>405</StatusCode>
           <ReasonPhrase>Method Not Allowed</ReasonPhrase>
       </Set>
       <Add>
           <Headers>
               <Header name="Allow">GET, POST, HEAD</Header>
           </Headers>
       </Add>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

2. Tạo một FaultRule trong TargetEndpoint để gọi chính sách khi gặp lỗi 502 với mã lỗi protocol.http.Response405WithoutAllowHeader.

   Cấu hình TargetEndpoint mẫu hiển thị FaultRule:

   <TargetEndpoint name="default">
   ...
       <FaultRules>
          <FaultRule name="405WithoutAllowHeader">
               <Step>
                   <Name>AM-405WithAllowHeader</Name>
               </Step>
               <Condition>(fault.name = "Response405WithoutAllowHeader")</Condition>
           </FaultRule>
       </FaultRules>
   

3. Lưu các thay đổi này trong bản sửa đổi mới của proxy API và triển khai bản sửa đổi đó.
4. Thực hiện lệnh gọi API và xác minh rằng bạn nhận được mã trạng thái 405 có tiêu đề Allow.

Định cấu hình tài sản

Cách 3: Định cấu hình thuộc tính trong Trình xử lý thư để ngăn Apigee Edge trả về lỗi 502

1. Nếu là người dùng Đám mây riêng tư, bạn có thể cập nhật thuộc tính HTTP.ignore.allow_header.for.405 thành true để ngăn quá trình Apigee Edge gây ra lỗi 502, ngay cả khi máy chủ phụ trợ phản hồi bằng mã trạng thái 405 mà không có tiêu đề Allow theo Hướng dẫn: Định cấu hình tiêu đề bỏ qua cho phép của thuộc tính 405 trong Bộ xử lý tin nhắn.
2. Nếu bạn là người dùng Public Cloud, vui lòng liên hệ với Nhóm hỗ trợ Apigee