Lỗi máy chủ nội bộ 500 - BadPath

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 một mã trạng thái HTTP của 500 Internal Server Error với mã lỗi protocol.http.BadPath 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 500 Internal Server Error

Ngoài ra, bạn có thể nhận thấy thông báo lỗi sau:

{
   "fault":{
      "faultstring":"Invalid request path",
      "detail":{
         "errorcode":"protocol.http.BadPath"
      }
   }
}

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

Lỗi này xảy ra nếu URL yêu cầu của máy chủ phụ trợ (được biểu thị bằng biến luồng target.url) chứa path bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/). Giá trị này không hợp lệ.

Theo thông số kỹ thuật RFC 3986, mục 3: Thành phần cú pháp và RFC 3986, mục 3.3: Đường dẫn:

1. Cú pháp URI có các thành phần sau:

           foo://example.com:8042/over/there?name=ferret#nose
           \_/   \______________/\_________/ \_________/ \__/
            |            |            |            |       |
         scheme      authority       path        query   fragment
   

2. Thành phần path là required và thành phần này PHẢI bắt đầu bằng và luôn có dấu gạch chéo lên (/).

Do đó, nếu URL yêu cầu của máy chủ phụ trợ có thành phần path bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/), thì Apigee sẽ phản hồi bằng 500 Internal Server Error và mã lỗi protocol.http.BadPath.

Ví dụ: Nếu target.url có giá trị https://www.mocktarget.apigee.net?json, thì lỗi này sẽ xảy ra vì path được phát hiện là không hợp lệ,vì lỗi này bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/).

Nguyên nhân	Nội dung mô tả	Hướng dẫn khắc phục sự cố áp dụng cho
URL máy chủ phụ trợ (target.url) có đường dẫn không hợp lệ	Thành phần đường dẫn trong URL của máy chủ phụ trợ được biểu thị bằng biến luồng target.url bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/).	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: URL máy chủ phụ trợ (target.url) có đường dẫn không hợp lệ

Chẩn đoán

1. Xác định Mã lỗi và Nguồn lỗi cho 500 Internal Server Error 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 thường gặp.
2. Nếu Mã lỗi là protocol.http.BadPath và Nguồn lỗi có giá trị target, thì tức là URL máy chủ phụ trợ có đường dẫn không hợp lệ.

3. URL máy chủ phụ trợ được biểu thị bằng biến luồng target.url trong Apigee Edge. Lỗi này thường xảy ra nếu bạn cố cập nhật URL của máy chủ phụ trợ (target.url) linh động bằng bất kỳ chính sách nào (trong luồng proxy/luồng dùng chung) trong quy trình yêu cầu mục tiêu, do đó có đường dẫn không hợp lệ.

4. Hãy xác định xem biến luồng target.url có thực sự có đường dẫn không hợp lệ và nguồn cho giá trị của biến đó 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

   Nếu bạn đã ghi lại dấu vết của lỗi này, hãy sử dụng các bước như giải thích trong bài viết Sử dụng công cụ Theo dõi và

   1. Xác minh xem target.url có đường dẫn không hợp lệ hay không, tức là nếu đường dẫn bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/).

   2. Nếu có, hãy tìm hiểu chính sách đã sửa đổi hoặc cập nhật giá trị của target.url để chứa đường dẫn không hợp lệ.

      Dấu vết mẫu cho thấy chính sách JavaScript đã cập nhật biến luồng target.url

      
   3. Trong dấu vết mẫu ở trên, hãy lưu ý rằng chính sách JavaScript đã sửa đổi hoặc cập nhật giá trị của target.url để chứa một đường dẫn không hợp lệ.
   4. Xin lưu ý rằng target.url có các thành phần sau:
      • lược đồ: https
      • authority: mocktarget.apigee.net
      • path: ?json

      Đường dẫn bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/), do đó không hợp lệ.

   Nhật ký

   Sử dụng nhật ký trong máy chủ nhật ký

   1. Nếu bạn không có dấu vết cho lỗi này (sự cố gián đoạn), hãy kiểm tra xem bạn đã ghi lại thông tin về giá trị của biến luồng target.url hay chưa, bằng cách sử dụng các chính sách như MessageLogging hoặc ServiceAnnotation đến máy chủ nhật ký.
   2. Nếu bạn có nhật ký, hãy kiểm tra và
      1. Xác minh xem target.url có đường dẫn không hợp lệ hay không và
      2. Xem liệu bạn có thể xác định thông tin về chính sách nào đã sửa đổi target.url để chứa đường dẫn không hợp lệ hay không

   Proxy API

   Xem lại proxy API không thành công

   Nếu bạn không có dấu vết hoặc nhật ký cho lỗi này, hãy xem lại proxy API không thành công để xác định hành động sửa đổi hoặc cập nhật biến luồng target.url để chứa đường dẫn không hợp lệ. Kiểm tra những thông tin sau:

   • Chính sách trong proxy API
   • Mọi luồng dùng chung được gọi từ proxy

5. Kiểm tra kỹ chính sách cụ thể (Ví dụ:: AssignmentsMessage hoặc JavaScript) sửa đổi hoặc cập nhật biến luồng target.url và xác định nguyên nhân để cập nhật target.url có đường dẫn không hợp lệ.

   Dưới đây là một số ví dụ về chính sách cập nhật biến luồng target.url không chính xác để chứa một đường dẫn không hợp lệ dẫn đến lỗi này.

   Mẫu số 1

   Ví dụ 1: Chính sách JavaScript cập nhật biến target.url

   var url = "https://mocktarget.apigee.net?json"
   context.setVariable("target.url", url);
   

   Trong mẫu trên, lưu ý rằng biến luồng target.url được cập nhật với giá trị https://mocktarget.apigee.net?json chứa trong một biến url. khác

   Xin lưu ý rằng giá trị của url có các thành phần sau:

   • lược đồ: https
   • authority: mocktarget.apigee.net
   • path: ?json

   Đường dẫn bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/), là dấu không hợp lệ. Do đó, Apigee Edge sẽ trả về 500 Internal Server Error kèm theo mã lỗi protocol.http.BadPath.

   Mẫu số 2

   Ví dụ 2: Chính sách JavaScript cập nhật biến target.url dựa trên giá trị trong tiêu đề yêu cầu

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);
   

   Trong mẫu trên, hãy lưu ý rằng biến luồng target.url được cập nhật bằng cách nối giá trị https://mocktarget.apigee.net có trong url và giá trị của một biến khác path, có giá trị được truy xuất từ request.header.Path.

   Nếu có quyền truy cập vào yêu cầu hoặc dấu vết thực tế, thì bạn có thể xác minh giá trị thực tế được truyền đến request.header.Path.

   Yêu cầu mẫu do người dùng đưa ra

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: ?user"
   

   Trong ví dụ này, đường dẫn tiêu đề không được gửi trong yêu cầu. Do đó, giá trị của biến path trong chính sách JavaScript là null.

   Vì vậy:

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + "?user"
   • target.url = https://mocktarget.apigee.net?user

   Xin lưu ý rằng giá trị của target.url có các thành phần sau:

   • lược đồ: https
   • authority: mocktarget.apigee.net
   • path: ?user

   Đường dẫn bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/), là dấu không hợp lệ. Do đó, Apigee Edge sẽ trả về 500 Internal Server Error với mã lỗi protocol.http.BadPath.

   Mẫu số 3

   Ví dụ 3: Chính sách composeMessage cập nhật biến target.url

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net?echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

   Xin lưu ý rằng giá trị của url có các thành phần sau:

   • lược đồ: https
   • authority: mocktarget.apigee.net
   • path: ?echo

   Một lần nữa, trong ví dụ này, đường dẫn bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/), là dấu không hợp lệ. Do đó, Apigee Edge sẽ trả về 500 Internal Server Error kèm theo mã lỗi protocol.http.BadPath.

Độ phân giải

Theo thông số kỹ thuật của URL RFC 3986, phần 3: Thành phần cú pháp, thành phần path là bắt buộc và phải luôn bắt đầu bằng "/". Vì vậy, hãy làm theo các bước dưới đây để khắc phục vấn đề này:

1. Đảm bảo rằng URL máy chủ phụ trợ (được biểu thị bằng biến luồng target.url) luôn có đường dẫn hợp lệ và URL này luôn bắt đầu bằng dấu gạch chéo lên (/).
   1. Trong một số trường hợp, bạn có thể không có tên tài nguyên trong đường dẫn, do đó hãy đảm bảo đường dẫn đó ít nhất có một dấu gạch chéo xuôi (/).
   2. Nếu bạn sử dụng bất kỳ biến nào khác để xác định giá trị của biến luồng target.url, hãy đảm bảo các biến khác không có đường dẫn không hợp lệ.
   3. Nếu bạn thực hiện bất kỳ thao tác chuỗi nào để xác định giá trị của biến luồng target.url, hãy đảm bảo rằng kết quả của các thao tác chuỗi không có đường dẫn không hợp lệ.

2. Trong các ví dụ được thảo luận ở trên, bạn có thể khắc phục sự cố này theo giải thích dưới đây:

   Mẫu số 1

   Ví dụ 1: Chính sách JavaScript cập nhật biến target.url

   Sử dụng dấu gạch chéo lên (/) thay vì dấu chấm hỏi (?) trong biến url để khắc phục vấn đề này như sau:

   var url = "https://mocktarget.apigee.net/json"
   context.setVariable("target.url", url);
   

   Mẫu số 2

   Ví dụ 2: Chính sách JavaScript cập nhật biến target.url dựa trên giá trị trong tiêu đề yêu cầu

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);
   

   Hãy đảm bảo rằng bạn truyền một đường dẫn hợp lệ, ví dụ: /user trong tiêu đề của yêu cầu Path để khắc phục vấn đề này như minh hoạ dưới đây:

   Yêu cầu mẫu:

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: /user"
   

   Mẫu số 3

   Mẫu số 3: Chính sách composeMessage cập nhật biến target.url

   Thêm một đường dẫn hợp lệ trong phần tử <Value> của chính sách AttributionMessage. Tức là thay thế dấu chấm hỏi (?) bằng dấu gạch chéo lên (/) trong phần tử <Value> và đặt thành https://mocktarget.apigee.net/echo để khắc phục vấn đề này như sau:

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net/echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

   Thông số kỹ thuật

   Apigee Edge dự kiến rằng path thành phần trong URL của máy chủ phụ trợ PHẢI luôn bắt đầu bằng dấu gạch chéo lên (/) theo thông số kỹ thuật sau đây:

   Thông số kỹ thuật
   RFC 3986, phần 3: Thành phần cú pháp
   RFC 3986, phần 3.3: Đường dẫn

   Nếu bạn vẫn cần Nhóm hỗ trợ Apigee hỗ trợ, hãy chuyển đến 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

   Nếu sự cố vẫn tiếp diễn sau khi đã làm theo hướng dẫn ở trên, hãy thu thập thông tin chẩn đoán sau đây rồi liên hệ với Bộ phận hỗ trợ 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 500 Internal Server Error có mã lỗi protocol.http.BadPath
   • 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

   Tài liệu tham khảo

   Biến luồng – mục tiêu