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ò phù 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 nhận thấy lỗi.

5. Vẽ Mã lỗi theo Thời gian.

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

   

7. Thông tin về mã lỗi protocol.http.Response405WithoutAllowHeader sẽ xuất hiện như hình dưới đây:

   

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ực hiện được để xem thêm thông tin.

   
9. Trong cửa sổ 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ụ Trace (Theo dõi):

1. Bật phiên theo dõi và một trong hai
   • Chờ lỗi 502 Bad Gateway 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 để tái hiện vấn đề – lỗi 502 Bad Gateway

2. Đảm bảo bạn đã bật chế độ Show all FlowInfos (Hiện tất cả FlowInfo):

   
3. Chọn một trong các yêu cầu không thực hiện được và kiểm tra dấu vết.
4. Điều hướng qua các giai đoạn khác nhau của dấu vết và xác định vị trí xảy ra lỗi.

5. Bạn thường sẽ thấy lỗi này trong một luồng sau giai đoạn Yêu cầu được gửi đến máy chủ đích như minh hoạ dưới đây:

   

6. Lưu ý 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 này do Apigee đưa ra sau khi yêu cầu được gửi đến máy chủ phụ trợ, nên lỗi này cho biết rằng máy chủ phụ trợ đã gửi mã trạng thái phản hồi 405 mà không có tiêu đề Allow.

7. Chuyển đến Giai đoạn AX (Dữ liệu Analytics được ghi lại) trong dấu vết rồi nhấp vào giai đoạn đó.

8. Di chuyển xuống phần Tiêu đề lỗi / phản hồi trong bảng điều khiển Thông tin chi tiết về giai đoạn và xác định các giá trị của X-Apigee-fault-code và X-Apigee-fault-source như minh hoạ 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 lần lượt là protocol.http.Response405WithoutAllowHeader và target, cho biết lỗi này xảy ra do 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, thì bạn có thể sử 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 thế bằng các giá trị thực tế.

3. Tì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 có X-Apigee-fault-code khớp với giá trị của protocol.http.Response405WithoutAllowHeader, hãy xác định giá trị của X-Apigee-fault-source.

   Ví dụ về lỗi 502 trong nhật ký truy cập của NGINX:

   

   Mục nhập mẫu ở trên trong 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ợ

Cách 1: Sửa Máy chủ phụ trợ để gửi mã trạng thái 405 kèm theo tiêu đề Cho phép:

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

   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

Cách 2: Sử dụng tính năng Xử lý lỗi để gửi mã trạng thái 405 kèm theo 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, bạn có thể sử dụng tính năng xử lý lỗi để phản hồi bằng mã trạng thái 405 và tiêu đề Allow từ proxy API của bạn 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 với tiêu đề Allow và thông báo tuỳ chỉnh.

   Chính sách AssignMessage mẫu để gửi 405 với 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, lệnh này sẽ gọi chính sách khi gặp lỗi 502 kèm theo mã lỗi protocol.http.Response405WithoutAllowHeader.

   Cấu hình TargetEndpoint mẫu cho thấy FaultRule:

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

3. Lưu những thay đổi này trong một bản sửa đổi mới của API proxy 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 đang nhận mã trạng thái 405 bằng 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 báo để 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 Apigee Edge đưa 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 bằng cách sử dụng hướng dẫn Cách thực hiện: Định cấu hình tiêu đề bỏ qua cho thuộc tính 405 trong Trình xử lý thông báo.
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 Edge