500 ข้อผิดพลาดภายในเซิร์ฟเวอร์ - EmptyPath

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

ลักษณะปัญหา

แอปพลิเคชันไคลเอ็นต์จะได้รับรหัสสถานะ HTTP 500 Internal Server Error พร้อม รหัสข้อผิดพลาด protocol.http.EmptyPath เป็นการตอบกลับสำหรับการเรียก API

ข้อความแสดงข้อผิดพลาด

แอปพลิเคชันไคลเอ็นต์จะได้รับโค้ดตอบกลับต่อไปนี้

HTTP/1.1 500 Internal Server Error

นอกจากนี้ คุณอาจเห็นข้อความแสดงข้อผิดพลาดต่อไปนี้

{
   "fault":{
      "faultstring":"Request path cannot be empty",
      "detail":{
         "errorcode":"protocol.http.EmptyPath"
      }
   }
}

สาเหตุที่เป็นไปได้

ข้อผิดพลาดนี้จะเกิดขึ้นหาก URL ของคำขอของเซิร์ฟเวอร์แบ็กเอนด์ซึ่งแสดงโดยตัวแปรโฟลว์ target.url มีเส้นทางว่างเปล่า

ตามข้อกำหนด RFC 3986 ส่วนที่ 3: องค์ประกอบไวยากรณ์ และ RFC 3986 ส่วนที่ 3.3: เส้นทาง:

1. ไวยากรณ์ URI มีคอมโพเนนต์ต่อไปนี้

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

2. คอมโพเนนต์ path เป็นข้อกำหนดและต้องมีเครื่องหมายทับ (/) เสมอ แม้ว่าจะไม่มีอักขระอื่นๆ เป็นส่วนหนึ่งของเส้นทางก็ตาม

ดังนั้น หาก URL ของคำขอของเซิร์ฟเวอร์แบ็กเอนด์ไม่มีคอมโพเนนต์ path เลย นั่นคือไม่มีแม้แต่เครื่องหมายทับ (/) Apigee Edge จะตอบกลับด้วย 500 Internal Server Error และรหัสข้อผิดพลาด protocol.http.EmptyPath

เช่น หาก target.url มีค่า https://www.mocktarget.apigee.net ข้อผิดพลาดนี้จะเกิดขึ้นเนื่องจาก คอมโพเนนต์ path ว่างเปล่าหรือไม่มี

ขั้นตอนการวินิจฉัยที่พบบ่อย

ใช้เครื่องมือ/เทคนิคอย่างใดอย่างหนึ่งต่อไปนี้เพื่อวินิจฉัยข้อผิดพลาดนี้

สาเหตุ: URL ของเซิร์ฟเวอร์แบ็กเอนด์ (target.url) มีเส้นทางว่างเปล่า

การวินิจฉัย

1. กำหนดรหัสข้อผิดพลาดและแหล่งที่มาของข้อผิดพลาดสำหรับ 500 Internal Server Error โดยใช้การตรวจสอบ API, เครื่องมือติดตาม หรือบันทึกการเข้าถึง NGINX ตามที่อธิบายไว้ใน ขั้นตอนการวินิจฉัยทั่วไป
2. หากรหัสข้อผิดพลาดคือ protocol.http.EmptyPath และแหล่งที่มาของข้อผิดพลาดมีค่าเป็น target แสดงว่า URL ของเซิร์ฟเวอร์แบ็กเอนด์มีเส้นทางว่าง

3. URL ของเซิร์ฟเวอร์แบ็กเอนด์แสดงด้วยตัวแปรโฟลว์ target.url ใน Apigee Edge ข้อผิดพลาดนี้มักเกิดขึ้นหากคุณพยายามอัปเดต URL ของเซิร์ฟเวอร์แบ็กเอนด์ ซึ่งก็คือ target.url แบบไดนามิกโดยใช้นโยบายใดนโยบายหนึ่ง (ภายใน Proxy/Shared Flow) ในโฟลว์คำขอเป้าหมาย เพื่อให้มีเส้นทางว่าง

4. ตรวจสอบว่าตัวแปรโฟลว์ target.url มีเส้นทางว่างจริงหรือไม่ และแหล่งที่มาของค่าโดยใช้ขั้นตอนใดขั้นตอนหนึ่งต่อไปนี้

   Trace

   การใช้เครื่องมือติดตาม

   หากคุณบันทึกการติดตามข้อผิดพลาดนี้ไว้ ให้ทำตามขั้นตอนที่อธิบายไว้ใน การใช้เครื่องมือติดตาม และ

   1. ตรวจสอบว่า target.url มีเส้นทางว่างเปล่าหรือไม่

   2. หากใช่ ให้ดูว่านโยบายใดที่แก้ไขหรืออัปเดตค่าของ target.url ให้มีเส้นทางว่าง

      ตัวอย่างการติดตามที่แสดงนโยบาย JavaScript ที่อัปเดตตัวแปรโฟลว์ target.url:

      
   3. ในตัวอย่างการติดตามด้านบน โปรดสังเกตว่านโยบาย JavaScript ได้แก้ไขหรือ อัปเดตค่าของ target.url ให้มีเส้นทางว่าง
   4. โปรดทราบว่า target.url มีองค์ประกอบต่อไปนี้
      • รูปแบบ: https://mocktarget.apigee.net
      • เส้นทาง: ว่างเปล่า

   บันทึก

   การใช้บันทึกในเซิร์ฟเวอร์บันทึก

   1. หากไม่มีการติดตามข้อผิดพลาดนี้ (ปัญหาที่เกิดขึ้นเป็นครั้งคราว) ให้ตรวจสอบว่าคุณได้บันทึกข้อมูลเกี่ยวกับค่าของตัวแปรโฟลว์ target.url โดยใช้นโยบายต่างๆ เช่น MessageLogging หรือ ServiceCallout ไปยังเซิร์ฟเวอร์บันทึกแล้วหรือไม่
   2. หากมีบันทึก ให้ตรวจสอบและทำดังนี้
      1. ตรวจสอบว่า target.url มีเส้นทางว่างเปล่าหรือไม่ และ
      2. ดูว่าคุณสามารถระบุนโยบายที่แก้ไข target.url ให้มีเส้นทางว่างได้หรือไม่

   พร็อกซี API

   ตรวจสอบพร็อกซี API ที่ล้มเหลว

   หากไม่มีการติดตามหรือบันทึกสำหรับข้อผิดพลาดนี้ ให้ตรวจสอบพร็อกซี API ที่ล้มเหลว เพื่อพิจารณาว่าอะไรที่แก้ไขหรืออัปเดตตัวแปรโฟลว์ target.url ให้มีเส้นทางที่ไม่ถูกต้อง โปรดตรวจสอบสิ่งต่อไปนี้

   • นโยบายภายในพร็อกซี API
   • โฟลว์ที่แชร์ซึ่งเรียกใช้จากพร็อกซี

5. ตรวจสอบนโยบายที่เฉพาะเจาะจง (เช่น AssignMessage หรือ JavaScript) ที่แก้ไขหรือ อัปเดตตัวแปรโฟลว์ target.url อย่างละเอียด และพิจารณาสาเหตุของการอัปเดต target.url ให้มีเส้นทางว่าง

   ต่อไปนี้คือตัวอย่างนโยบายบางส่วนที่อัปเดตตัวแปรโฟลว์ target.url อย่างไม่ถูกต้องให้มีเส้นทางว่างซึ่งทำให้เกิดข้อผิดพลาดนี้

   ตัวอย่างที่ 1

   ตัวอย่างที่ 1: การอัปเดตนโยบาย JavaScript target.url ตัวแปร

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

   ในตัวอย่างข้างต้น โปรดสังเกตว่าตัวแปรโฟลว์ target.url ได้รับการอัปเดต ด้วยค่า https://mocktarget.apigee.net ที่อยู่ในตัวแปรอื่น url

   โปรดทราบว่า target.url มีองค์ประกอบต่อไปนี้

   • รูปแบบ: https://mocktarget.apigee.net
   • เส้นทาง: ว่างเปล่า

   เนื่องจากเส้นทางว่างเปล่า Apigee Edge จึงแสดง 500 Internal Server Error พร้อม รหัสข้อผิดพลาด protocol.http.EmptyPath

   ตัวอย่าง #2

   ตัวอย่างที่ 2: การอัปเดตนโยบาย JavaScript target.url ตัวแปร

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

   ในตัวอย่างข้างต้น โปรดสังเกตว่าตัวแปรโฟลว์ target.url ได้รับการอัปเดตโดย การต่อค่า https://mocktarget.apigee.net ที่อยู่ในตัวแปร url และ ค่าของตัวแปรอื่น path ซึ่ง ค่าจะดึงมาจาก request.header.Path.

   หากคุณมีสิทธิ์เข้าถึงคำขอหรือการติดตามจริง คุณจะยืนยันค่าจริงที่ส่งไปยัง request.header.Path ได้

   คำขอตัวอย่างที่ผู้ใช้ส่ง

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

   ในตัวอย่างนี้ ระบบจะไม่ส่งเส้นทางส่วนหัวเป็นส่วนหนึ่งของคำขอ ดังนั้น ค่า ของเส้นทางตัวแปรในนโยบาย JavaScript คือ null

   ดังนั้น

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

   โปรดทราบว่า target.url มีองค์ประกอบต่อไปนี้

   • รูปแบบ: https://mocktarget.apigee.netnull
   • เส้นทาง: ว่างเปล่า

   ตัวอย่างที่ 3

   ตัวอย่างที่ 3: อัปเดตนโยบาย AssignMessage 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</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

   โปรดทราบว่า target.url มีองค์ประกอบต่อไปนี้

   • รูปแบบ: https://mocktarget.apigee.net
   • เส้นทาง: ว่างเปล่า

   ในตัวอย่างทั้งหมดข้างต้น เส้นทางใน URL ของเซิร์ฟเวอร์แบ็กเอนด์ ซึ่งก็คือ target.url ว่างเปล่า ดังนั้น Apigee Edge จึงแสดง 500 Internal Server Error พร้อมรหัสข้อผิดพลาด protocol.http.EmptyPath

ความละเอียด

ตามข้อกำหนด RFC 3986 ส่วนที่ 2: คอมโพเนนต์ไวยากรณ์ คอมโพเนนต์ path เป็นข้อกำหนดและต้องมีเครื่องหมายทับ (/) เสมอ แม้ว่าจะไม่มีอักขระอื่นๆ เป็นส่วนหนึ่งของ path ก็ตาม ทำตามขั้นตอนต่อไปนี้เพื่อ แก้ไขปัญหานี้

1. ตรวจสอบว่า URL ของเซิร์ฟเวอร์แบ็กเอนด์ซึ่งแสดงโดยตัวแปรโฟลว์ target.url มีเส้นทางที่ไม่ว่างเปล่าเสมอ
   1. ในบางกรณี คุณอาจไม่มีชื่อทรัพยากรในเส้นทาง จากนั้นตรวจสอบว่าเส้นทางมีเครื่องหมายทับ (/) อย่างน้อย 1 ตัว
   2. หากคุณใช้ตัวแปรอื่นๆ เพื่อกำหนดค่าของตัวแปรโฟลว์ target.url โปรดตรวจสอบว่าตัวแปรอื่นๆ ไม่มีเส้นทางว่าง
   3. หากคุณดำเนินการกับสตริงเพื่อกำหนดค่าของตัวแปรโฟลว์ target.url โปรดตรวจสอบว่าผลลัพธ์หรือผลของการดำเนินการกับสตริง ไม่มีเส้นทางว่าง
2. ในตัวอย่างที่กล่าวถึงในการวินิจฉัย คุณสามารถแก้ไขปัญหานี้ได้ตามที่อธิบายไว้ด้านล่าง

   ตัวอย่างที่ 1

   ตัวอย่างที่ 1: การอัปเดตนโยบาย JavaScript target.url ตัวแปร

   เพิ่มเครื่องหมายทับ (/) ลงในตัวแปร url เพื่อแก้ไขปัญหานี้ ตามที่แสดงด้านล่าง

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

   ตัวอย่าง #2

   ตัวอย่างที่ 2: การอัปเดตนโยบาย JavaScript target.url ตัวแปร

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

   ตรวจสอบว่าคุณได้ส่งเส้นทางที่ถูกต้อง เช่น /iloveapis เป็นส่วนหนึ่งของ ส่วนหัวของคำขอ Path เพื่อแก้ไขปัญหานี้ตามที่แสดงด้านล่าง

   ตัวอย่างคำขอ:

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

   ตัวอย่างที่ 3

   ตัวอย่างที่ 3: นโยบาย AssignMessage ที่อัปเดตตัวแปร target.url ผ่าน ตัวแปรอื่น

   เพิ่มเส้นทางที่ถูกต้องในองค์ประกอบ <Value> ของนโยบาย AssignMessage ตัวอย่างเช่น คุณสามารถใช้ /json เป็นเส้นทางสำหรับ MockTarget API กล่าวคือ แก้ไของค์ประกอบ <Value> เป็น https://mocktarget.apigee.net/json ดังที่แสดงด้านล่าง

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

ข้อมูลจำเพาะ

Apigee Edge คาดหวังว่า URL ของเซิร์ฟเวอร์แบ็กเอนด์ จะไม่มีเส้นทางว่างตาม ข้อกำหนดต่อไปนี้

หากยังต้องการความช่วยเหลือจากทีมสนับสนุนของ Apigee โปรดไปที่ ต้องรวบรวมข้อมูลการวินิจฉัย

ต้องรวบรวมข้อมูลการวินิจฉัย

หากยังพบปัญหาเดิมอยู่แม้จะทำตามวิธีการข้างต้นแล้ว โปรดรวบรวมข้อมูลการวินิจฉัยต่อไปนี้ แล้วติดต่อทีมสนับสนุนของ Apigee Edge

หากคุณเป็นผู้ใช้ระบบคลาวด์สาธารณะ โปรดระบุข้อมูลต่อไปนี้

• ชื่อองค์กร
• ชื่อสภาพแวดล้อม
• ชื่อพร็อกซี API
• คำสั่ง curl ที่สมบูรณ์ซึ่งใช้ในการสร้าง 500 Internal Server Error ซ้ำโดยมีรหัสข้อผิดพลาด protocol.http.EmptyPath
• ไฟล์การติดตามสำหรับคำขอ API

หากคุณเป็นผู้ใช้ Private Cloud โปรดระบุข้อมูลต่อไปนี้

• ข้อความแสดงข้อผิดพลาดทั้งหมดที่พบสำหรับคำขอที่ไม่สำเร็จ
• ชื่อสภาพแวดล้อม
• แพ็กเกจพร็อกซี API
• ไฟล์การติดตามสำหรับคำขอ API

• บันทึกการเข้าถึง NGINX

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

  โดยที่ ORG, ENV และ PORT# จะถูกแทนที่ด้วย ค่าจริง

• บันทึกของระบบ Message Processor /opt/apigee/var/log/edge-message- processor/logs/system.log

ข้อมูลอ้างอิง