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

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.EmptyPath 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":"Request path cannot be empty",
      "detail":{
         "errorcode":"protocol.http.EmptyPath"
      }
   }
}

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 một đường dẫn trống.

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à bắt buộc và thành phần này PHẢI luôn có dấu gạch chéo lên (/), ngay cả khi không có ký tự nào khác trong đường dẫn.

Do đó, nếu URL yêu cầu của máy chủ phụ trợ hoàn toàn không có thành phần path, tức là URL đó thậm chí không có 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.EmptyPath.

Ví dụ: Nếu target.url có giá trị https://www.mocktarget.apigee.net, thì lỗi này sẽ xảy ra vì thành phần path bị trống hoặc bị thiếu.

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 trống	URL máy chủ phụ trợ được biểu thị bằng biến luồng target.url có một đường dẫn trống.	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 trống

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.EmptyPath và Nguồn lỗi có giá trị target, thì tức là URL máy chủ phụ trợ có một đường dẫn trống.

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ợ, tức là target.url linh động dùng bất kỳ chính sách nào (trong quy trình Proxy/dùng chung) trong quy trình yêu cầu Mục tiêu, sao cho URL có đường dẫn trống.

4. Hãy xác định xem biến luồng target.url có thực sự có đường dẫn trống và nguồn cho giá trị của biến hay không bằng một trong các bước sau:

   Trace

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

   Nếu bạn đã thu thập được dấu vết của lỗi này, hãy làm theo 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 trống hay không.

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

      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 trống.
   4. Xin lưu ý rằng target.url có các thành phần sau:
      • lược đồ: https://mocktarget.apigee.net
      • path: trống

   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ố không liên tục), 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 ServiceChú thích đế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 trống hay không và
      2. Xem liệu bạn có thể xác định chính sách nào đã sửa đổi target.url để chứa đường dẫn trố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. Hãy kiểm tra kỹ một chính sách cụ thể (ví dụ:assignMessage hoặc JavaScript) sửa đổi hoặc cập nhật biến luồng target.url một cách cẩn thận và xác định nguyên nhân cập nhật target.url để có đường dẫn trống.

   Dưới đây là một vài 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 trống 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"
   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 với giá trị https://mocktarget.apigee.net chứa trong một biến url khác.

   Hãy lưu ý rằng target.url có các thành phần sau:

   • lược đồ: https://mocktarget.apigee.net
   • path: trống

   Vì đường dẫn trống nên Apigee Edge sẽ trả về 500 Internal Server Error kèm theo mã lỗi protocol.http.EmptyPath.

   Mẫu số 2

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

   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 biến 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>
   

   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 đường dẫn biến trong chính sách JavaScript là null.

   Vì vậy:

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + null
   • target.url = https://mocktarget.apigee.netnull

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

   • lược đồ: https://mocktarget.apigee.netnull
   • path: trống

   Mẫu số 3

   Ví dụ 3: Chính sách AttributionMessage cập nhật biến target.url thông qua một biến khác

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

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

   • lược đồ: https://mocktarget.apigee.net
   • path: trống

   Trong tất cả các ví dụ trên, đường dẫn trong URL máy chủ phụ trợ, tức là target.url trống, do đó Apigee Edge sẽ trả về 500 Internal Server Error có mã lỗi protocol.http.EmptyPath.

Độ phân giải

Theo thông số kỹ thuật RFC 3986, phần 2: Thành phần cú pháp, thành phần path là required và phải luôn có dấu gạch chéo lên (/), ngay cả khi không có ký tự nào khác trong path. Hãy thực hiện các bước sau để 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 không trống.
   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 rằng các biến khác không có đường dẫn trống.
   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ả hoặc kết quả của các thao tác chuỗi không có đường dẫn trống.
2. Trong các ví dụ được thảo luận ở phần Chẩn đoán, bạn có thể khắc phục vấn đề 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

   Thêm dấu gạch chéo lên (/) vào biến url để khắc phục vấn đề này như sau:

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

   Mẫu số 2

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

   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ụ: /iloveapis trong tiêu đề yêu cầu Path để khắc phục vấn đề này như sau:

   Yêu cầu mẫu:

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

   Mẫu số 3

   Ví dụ 3: Chính sách composeMessage cập nhật biến target.url thông qua một biến khác

   Thêm một đường dẫn hợp lệ trong phần tử <Value> của chính sách AttributionMessage. Ví dụ: bạn có thể dùng /json làm đường dẫn cho MockTarget API. Tức là hãy sửa đổi phần tử <Value> thành https://mocktarget.apigee.net/json như minh hoạ dưới đây:

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net/json</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 URL máy chủ phụ trợ không có đường dẫn trống theo các thông số kỹ thuật sau:

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 truy cập 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 Nhóm 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.EmptyPath
• 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