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

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Dấu hiệu

Ứng dụng khách nhận được mã trạng thái HTTP 500 Internal Server Error với mã lỗi protocol.http.EmptyPath làm phản hồi cho các 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:

HTTP/1.1 500 Internal Server Error

Ngoài ra, bạn có thể 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ợ (do biến luồng target.url biểu thị) chứa một đường dẫn trống.

Theo quy cách RFC 3986, phần 3: Thành phần cú pháp và RFC 3986, phần 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à LUÔN PHẢI có dấu gạch chéo xuôi (/), 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à thậm chí không có dấu gạch chéo (/), thì Apigee Edge 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 trống hoặc bị thiếu.

Các bước chẩn đoán thường gặp

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 cách sử dụ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ư được 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ị là target, thì điều này có nghĩa là URL máy chủ phụ trợ có đườ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ố gắng cập nhật URL máy chủ phụ trợ, tức là target.url động bằng cách sử dụng bất kỳ chính sách nào (trong Proxy/luồng chia sẻ) trong luồng Yêu cầu mục tiêu, sao cho chính sách đó có một đường dẫn trống.

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

   Trace

   Sử dụng công cụ Trace

   Nếu bạn đã ghi lại dấu vết cho lỗi này, hãy làm theo các bước như được giải thích trong phần 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:
      • scheme: 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 (một vấn đề không liên tục), hãy kiểm tra để xem bạn đã ghi 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 ServiceCallout cho máy chủ nhật ký của bạn.
   2. Nếu bạn có nhật ký, hãy xem xét nhật ký đó 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 một đường dẫn trống hay không

   API proxy

   Xem xét 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 xét proxy API không thành công để xác định những gì đã sửa đổi hoặc cập nhật biến luồng target.url để chứa một đường dẫn không hợp lệ. Kiểm tra những điều sau:

   • Chính sách trong proxy API
   • Mọi quy trình được chia sẻ đều được gọi từ proxy

5. Kiểm tra kỹ 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 và xác định nguyên nhân khiến target.url được cập nhật để có một đường dẫn trống.

   Sau đây là một vài ví dụ về các 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: Biến target.url cập nhật Chính sách JavaScript

   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 bằng giá trị https://mocktarget.apigee.net có trong một biến khác url.

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

   • scheme: https://mocktarget.apigee.net
   • path: trống

   Vì đường dẫn trống, Apigee Edge trả về 500 Internal Server Error với mã lỗi protocol.http.EmptyPath.

   Mẫu số 2

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

   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, giá trị của biến này đượ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.

   Do đó:

   • 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:

   • scheme: https://mocktarget.apigee.netnull
   • path: trống

   Ví dụ 3

   Ví dụ 3: Chính sách AssignMessage 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:

   • scheme: 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) đều trống. Do đó, Apigee Edge sẽ trả về 500 Internal Server Error với mã lỗi protocol.http.EmptyPath.

Độ phân giải

Theo quy cách RFC 3986, phần 2: Thành phần cú pháp, thành phần path là bắt buộc và LUÔN PHẢI 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ợ (do biến luồng target.url biểu thị) 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, sau đó đảm bảo rằng đường dẫn có ít nhất một dấu gạch chéo lên (/).
   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 nào trên chuỗi để 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 đầu ra của các thao tác trên chuỗi không có đường dẫn trống.
2. Trong các mẫu được thảo luận trong phần Chẩn đoán, bạn có thể khắc phục vấn đề này như giải thích dưới đây:

   Mẫu số 1

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

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

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

   Mẫu số 2

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

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

   Đảm bảo rằng bạn truyền một đường dẫn hợp lệ, ví dụ: /iloveapis 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: /iloveapis"
   

   Ví dụ 3

   Ví dụ 3: Chính sách AssignMessage 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ệ vào phần tử <Value> của chính sách AssignMessage. Ví dụ: bạn có thể có /json làm đường dẫn cho MockTarget API. Tức là 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 yêu cầu URL máy chủ phụ trợ không có đường dẫn trống theo các quy cách sau:

Nếu bạn vẫn cần được Nhóm hỗ trợ Apigee trợ giúp, hãy truy cập vào phần Thông tin chẩn đoán bắt buộc phải thu thập.

Phải thu thập thông tin chẩn đoán

Nếu vấn đề vẫn tiếp diễn ngay cả sau khi bạn 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 Edge.

Nếu bạn là người dùng Đám mây công cộng, hãy cung cấp những thông tin sau:

• Tên tổ chức
• Tên môi trường
• Tên API Proxy
• Lệnh curl hoàn chỉnh được dùng để tái tạo 500 Internal Server Error bằng 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, hãy cung cấp những thông tin sau:

• Thông báo lỗi hoàn chỉnh được ghi nhận cho 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 bằng các giá trị thực tế.

• Nhật ký hệ thống của Trình xử lý tin nhắn /opt/apigee/var/log/edge-message- processor/logs/system.log

Tài liệu tham khảo