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

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

ลักษณะปัญหา

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

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

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

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

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

การวินิจฉัย

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

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

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

มาดูสาเหตุทีละขั้นตอนและวิธีแก้ปัญหากัน

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

ข้อความ “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 แสดงผลข้อผิดพลาดนี้

การวินิจฉัย

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

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

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

ความละเอียด

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

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

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

การวินิจฉัย

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

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

2. ในการติดตาม UI ตัวอย่างที่แสดงด้านบน เราพบว่านโยบาย JavaScript "BuildTargetAPIRequest" เรียกใช้ URL เป้าหมายไม่สำเร็จ

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

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

   curl -v <target URL>
   

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

ความละเอียด

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

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

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