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

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

ลักษณะปัญหา

แอปพลิเคชันไคลเอ็นต์ได้รับรหัสสถานะ 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) มีเส้นทางที่ว่างเปล่า	URL ของเซิร์ฟเวอร์แบ็กเอนด์ที่แสดงโดยตัวแปรโฟลว์ target.url มีเส้นทางว่าง	ผู้ใช้ Edge สาธารณะและ Private Cloud

ขั้นตอนการวินิจฉัยทั่วไป

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

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

การวินิจฉัย

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

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

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 โดยใช้นโยบายต่างๆ เช่น MessageLcking หรือ Serviceข้อความไฮไลต์ ไปยังเซิร์ฟเวอร์บันทึก
   2. หากคุณมีบันทึก ให้ตรวจสอบและดำเนินการดังนี้
      1. ตรวจสอบว่า target.url มีเส้นทางว่างหรือไม่ และ
      2. ดูว่าคุณระบุนโยบายที่มีการแก้ไข target.url ได้หรือไม่ ให้มีเส้นทางว่าง

   พร็อกซี API

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

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

   • นโยบายภายในพร็อกซี API
   • มีการเรียกขั้นตอนที่แชร์จากพร็อกซี

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

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

   ตัวอย่าง #1

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

   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: การอัปเดตตัวแปร target.url เกี่ยวกับนโยบาย JavaScript

   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: การอัปเดตตัวแปร target.url เกี่ยวกับนโยบาย AssignMessage ผ่าน ตัวแปรอื่น

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

   ตัวอย่าง #1

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

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

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

   ตัวอย่าง #2

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

   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 ของเซิร์ฟเวอร์แบ็กเอนด์ ไม่มีเส้นทางว่างตาม ข้อกำหนดต่อไปนี้

ข้อมูลจำเพาะ
RFC 3986 ส่วนที่ 3: คอมโพเนนต์ไวยากรณ์
RFC 3986 ส่วนที่ 3.3: เส้นทาง

หากยังต้องการความช่วยเหลือจากทีมสนับสนุนของ 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# ด้วย มูลค่าจริง

• บันทึกระบบของผู้ประมวลผลข้อความ /opt/apigee/var/log/edge-message- processor/logs/system.log

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

ตัวแปรโฟลว์ - เป้าหมาย