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

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

ลักษณะปัญหา

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

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

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

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

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

การวินิจฉัย

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

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

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

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

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

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

ความละเอียด

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

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

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

ความละเอียด

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

พร็อกซี Smartdocs ที่ส่งคืนข้อยกเว้น

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

การวินิจฉัย

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

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

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

ความละเอียด

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

Edge Message Processor เรียกใช้ปลายทาง API ที่เผยแพร่ไม่ได้

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

การวินิจฉัย

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

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

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

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

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

   curl -v <target URL>
   

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

ความละเอียด

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

2. หากคุณสามารถดำเนินการเรียก API โดยตรงจากโปรแกรมประมวลผลข้อความได้ ก็มีแนวโน้มสูงที่คุณจะสามารถเรียกใช้ API ผ่าน SmartDOC ได้เช่นกัน

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