ข้อผิดพลาดภายในของพอร์ทัลนักพัฒนาซอฟต์แวร์

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

ลักษณะปัญหา

พบข้อผิดพลาดเมื่อส่งคำขอ API แบบสดโดยใช้ SmartDocs จากพอร์ทัลนักพัฒนาซอฟต์แวร์

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

ข้อผิดพลาดทั่วไปที่พบในพอร์ทัลนักพัฒนาซอฟต์แวร์คือ "เกิดข้อผิดพลาดภายใน โปรดลองส่งคำขออีกครั้ง"

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

ข้อผิดพลาดนี้อาจเกิดขึ้นเมื่อพอร์ทัลนักพัฒนาซอฟต์แวร์ไม่ได้รับการตอบกลับจากแบ็กเอนด์ (พร็อกซี SmartDocs หรือปลายทางจริง)

การวินิจฉัย

เปิดใช้ "เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์" ในเบราว์เซอร์ แล้วตรวจสอบแท็บเครือข่ายเพื่อ ระบุข้อผิดพลาดที่เกิดขึ้นจริง

ข้อผิดพลาดทั่วไปและสาเหตุที่พบบ่อยแสดงอยู่ในตารางต่อไปนี้

ข้อผิดพลาด	สาเหตุที่พบบ่อย
ERR_NAME_NOT_RESOLVED	พร็อกซี SmartDocs กำหนดค่าไม่ถูกต้องหรือมีข้อจำกัดด้านไฟร์วอลล์ ของเครือข่าย
เนื้อหาผสม	พอร์ทัลกำหนดค่าผ่าน HTTPS, คำขอ SmartDocs ผ่าน HTTP
500 - ข้อผิดพลาดภายในเซิร์ฟเวอร์	พร็อกซี SmartDocs แสดงข้อผิดพลาด ตัวประมวลผลข้อความ Edge ไม่สามารถเรียกปลายทาง API ที่เผยแพร่

มาดูสาเหตุแต่ละข้อและขั้นตอนในการแก้ปัญหาทีละข้อกัน

พร็อกซี SmartDocs กำหนดค่าไม่ถูกต้องหรือมีข้อจำกัดด้านไฟร์วอลล์ของเครือข่าย

ข้อความ "ERR_NAME_NOT_RESOLVED" บ่งชี้ว่า URL ของพร็อกซี SmartDocs กำหนดค่าไม่ถูกต้อง หรือเครือข่ายที่ใช้เข้าถึงพอร์ทัล ไม่สามารถเรียก URL ของพร็อกซี SmartDocs ได้เนื่องจากข้อจำกัดด้านไฟร์วอลล์ พร็อกซี SmartDocs ต้องเข้าถึงได้จากอินเทอร์เน็ตหรือจากเครือข่ายภายใน (สำหรับ API ภายใน)

ความละเอียด

ตรวจสอบว่าพร็อกซี SmartDocs เข้าถึงได้จากเครือข่ายที่จำเป็นทั้งหมดโดยการติดตั้งใช้งาน พร็อกซี SmartDocs กับ โฮสต์เสมือน ใน Edge ที่มีชื่อโฮสต์ที่ เข้าถึงได้จากอินเทอร์เน็ต

พอร์ทัลกำหนดค่าผ่าน HTTPS, คำขอ SmartDocs ผ่าน HTTP

ข้อผิดพลาด “เนื้อหาผสม” บ่งชี้ว่ามีการเรียกพร็อกซี SmartDocs ผ่าน HTTP จากหน้าที่โหลดผ่าน HTTPS

ความละเอียด

เปิดเผยพร็อกซี SmartDocs ผ่าน HTTPS เพื่อแก้ปัญหา คุณทำได้โดยการติดตั้งใช้งานพร็อกซี SmartDocs ให้รวมโฮสต์เสมือนที่กำหนดค่าให้ใช้ TLS/SSL (โดยปกติจะเป็นโฮสต์เสมือน "ปลอดภัย")

พร็อกซี SmartDocs แสดงข้อยกเว้น

ข้อความ 500 - ข้อผิดพลาดภายในเซิร์ฟเวอร์ อาจเกิดจากปัญหาเกี่ยวกับ พร็อกซี "smartdocs" ในกรณีนี้ คุณจะสังเกตเห็นว่าพร็อกซี SmartDocs แสดงข้อผิดพลาดนี้

การวินิจฉัย

ใช้เครื่องมือ Trace เพื่อวินิจฉัยข้อผิดพลาดเกี่ยวกับพร็อกซี "smartdocs" ตามที่อธิบายไว้ ด้านล่าง ดูข้อมูลเพิ่มเติมได้ที่การใช้เครื่องมือ Trace

1. เปิดใช้การติดตามสำหรับพร็อกซี “smartdocs” ใน องค์กร “VALIDATE” เพื่อค้นหานโยบายเฉพาะที่ แสดงข้อผิดพลาดภายในเซิร์ฟเวอร์ 500

2. เลือกนโยบายเฉพาะในการติดตามเพื่อระบุสาเหตุของข้อผิดพลาด

ความละเอียด

แก้ไขข้อผิดพลาดที่ระบุ หากต้องการความช่วยเหลือ โปรดติดต่อ ทีมสนับสนุนของ Apigee Edge

ตัวประมวลผลข้อความ Edge ไม่สามารถเรียกปลายทาง API ที่เผยแพร่

ข้อผิดพลาดภายในเซิร์ฟเวอร์ 500 อาจเกิดขึ้นได้เช่นกันเมื่อตัวประมวลผลข้อความที่เป็นของ องค์กรที่โฮสต์พร็อกซี SmartDocs ไม่สามารถเรียกปลายทาง API ได้

การวินิจฉัย

ใช้เครื่องมือ Trace เพื่อวินิจฉัยข้อผิดพลาดเกี่ยวกับพร็อกซี "smartdocs" ตามที่อธิบายไว้ ด้านล่าง ดูข้อมูลเพิ่มเติมได้ที่การใช้เครื่องมือ Trace

1. เปิดใช้การติดตาม สำหรับพร็อกซี “smartdocs” ในองค์กร “VALIDATE” เพื่อค้นหานโยบายเฉพาะ ที่แสดงข้อผิดพลาดภายในเซิร์ฟเวอร์ 500

2. ในการติดตาม UI ตัวอย่างที่แสดงด้านบน คุณจะเห็นว่านโยบาย JavaScript “BuildTargetAPIRequest” ไม่สามารถเรียกใช้ URL เป้าหมายได้

3. รับ URL เป้าหมายจากนโยบาย JavaScript “BuildTargetAPIRequest”.

4. เรียก URL โดยตรงจากโหนด Message Processor ที่เชื่อมโยงกับ “VALIDATE” องค์กร ดังที่แสดงด้านล่าง

   curl -v <target URL>

5. แก้ไขข้อผิดพลาดที่พบ

ความละเอียด

1. ตรวจสอบว่า API ที่เผยแพร่ในพอร์ทัลนักพัฒนาซอฟต์แวร์เรียกใช้ได้จากตัวประมวลผลข้อความ ที่เชื่อมโยงกับองค์กร “VALIDATE” และแก้ไขข้อผิดพลาด ที่พบ

2. หากคุณเรียกใช้การเรียก API ได้โดยตรงจาก Message Processor ก็เป็นไปได้มากที่คุณจะเรียกใช้ API ผ่าน SmartDocs ได้เช่นกัน

3. เรียกใช้การเรียก API ผ่าน SmartDocs แล้วตรวจสอบว่าปัญหาได้รับการแก้ไขแล้วหรือไม่