درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
هنگام ایجاد درخواست زنده میانای برنامه‌سازی کاربردی بااستفاده از SmartDocs از درگاه توسعه‌دهنده، خطایی روی داد.
پیام های خطا
خطای رایجی که در «درگاه توسعه‌دهندگان» دیده می‌شود این است: «خطای داخلی رخ داده است. لطفاً درخواستتان را دوباره امتحان کنید».
علل احتمالی
این خطا زمانی رخ می‌دهد که «درگاه توسعه‌دهندگان» نتواند از زیرینه (پراکسی smartdocs یا نقطه پایانی واقعی) پاسخ دریافت کند.
تشخیص
«ابزارهای توسعه‌دهنده» را در مرورگرتان فعال کنید و برگه شبکه را بررسی کنید تا خطای واقعی را شناسایی کنید.
خطاهای رایج و دلایل معمول آن‌ها در جدول زیر فهرست شده است:
|
خطا |
علت(های) معمول |
|
ERR_NAME_NOT_RESOLVED |
پراکسی SmartDocs پیکربندی نادرست یا محدودیت‌های دیوار آتش شبکه |
|
محتوای ترکیبی |
درگاه ازطریق HTTPs پیکربندی شده است، درخواست SmartDocs ازطریق HTTP |
|
۵۰۰ - خطای سرور داخلی |
بیایید هریک از این دلایل و مراحل حل مشکل را یک‌به‌یک بررسی کنیم.
پیکربندی نادرست پراکسی SmartDocs یا محدودیت‌های دیواره آتش شبکه
پیام «ERR_NAME_NOT_RESOLVED» نشان می‌دهد که نشانی وب پراکسی smartdocs پیکربندی نادرست دارد یا شبکه مورداستفاده برای دسترسی به درگاه به‌دلیل محدودیت‌های دیوار آتش نمی‌تواند با نشانی وب پراکسی smartdocs تماس برقرار کند. کارگزار هوشمندسندها باید از اینترنت یا از شبکه داخلی (برای میاناهای برنامه‌سازی کاربردی داخلی) دسترس‌پذیر باشد.
وضوح
با استقرار پراکسی smartdocs در میزبان مجازی در Edge با نام میزبانی که از اینترنت قابل‌دسترسی است، مطمئن شوید که پراکسی smartdocs از همه شبکه‌های موردنیاز قابل‌دسترسی است.
درگاه ازطریق HTTPS پیکربندی شده است، درخواست SmartDocs ازطریق HTTP
خطای «محتوای ترکیبی» نشان می‌دهد که کارگزار هوشمندسندها از صفحه‌ای که ازطریق HTTPS بار شده است ازطریق HTTP فراخوانی می‌شود.
وضوح
برای حل کردن مشکل، پراکسی smartdocs را ازطریق https آشکار کنید. می‌توانید با استقرار پراکسی smartdocs این کار را انجام دهید تا میزبان مجازی پیکربندی‌شده برای استفاده از TLS/SSL (معمولاً میزبان مجازی «امن») را اضافه کنید.
پراکسی SmartDocs استثنایی برمی‌گرداند
پیام ۵۰۰ - خطای سرور داخلی می‌تواند ناشی از مشکلی در پراکسی «smartdocs» باشد. در این مورد، متوجه می‌شوید که پراکسی smartdocs این خطا را برمی‌گرداند.
تشخیص
از ابزار «ردیابی» برای تشخیص خطاهای کارگزار «سندهای هوشمند» استفاده کنید، همان‌طور که در زیر توضیح داده شده است. برای اطلاعات بیشتر، استفاده از ابزار ردیابی را ببینید.
- ردیابی را برای پراکسی «smartdocs» در سازمان «VALIDATE» فعال کنید تا خط‌مشی خاصی را که خطای «۵۰۰: خطای سرور داخلی» را برمی‌گرداند پیدا کنید.
- خط‌مشی خاص را در ردیابی انتخاب کنید تا علت خطا را شناسایی کنید.
وضوح
خطای شناسایی‌شده را برطرف کنید. درصورت نیاز به راهنمایی، با پشتیبانی Apigee Edge تماس بگیرید.
«پردازشگرهای پیام Edge» نمی‌توانند نقطه پایان «میانای برنامه‌سازی کاربردی» منتشرشده را فراخوانی کنند
۵۰۰ - خطای سرور داخلی همچنین زمانی می‌تواند رخ دهد که «پردازشگرهای پیام» متعلق به سازمانی که میزبان پراکسی Smartdocs است نتوانند نقطه پایانی «میانای برنامه‌سازی کاربردی» را فراخوانی کنند.
تشخیص
از ابزار «ردیابی» برای تشخیص خطاهای کارگزار «سندهای هوشمند» استفاده کنید، همان‌طور که در زیر توضیح داده شده است. برای اطلاعات بیشتر، استفاده از ابزار ردیابی را ببینید.
- برای یافتن خط‌مشی خاصی که خطای «۵۰۰: خطای سرور داخلی» را برمی‌گرداند، ردیابی را برای پراکسی «smartdocs» در سازمان «VALIDATE» فعال کنید.
- در ردیابی واسط کاربر نمونه نشان‌داده‌شده در بالا، دیده می‌شود که خط‌مشی جاوا اسکریپت «BuildTargetAPIRequest» نمی‌تواند نشانی وب هدف را اجرا کند.
- نشانی وب هدف را از خط‌مشی جاوا اسکریپت «BuildTargetAPIRequest» دریافت کنید.
- از گره‌های «پردازشگر پیام» منسوب به سازمان
“VALIDATE” همان‌طور که در زیر نشان داده شده است، مستقیماً با نشانی وب تماس بگیرید:
curl -v <target URL>
- هر خطایی را که مشاهده کردید اصلاح کنید.
وضوح
- مطمئن شوید که «میاناهای برنامه‌سازی کاربردی» منتشرشده در «درگاه توسعه‌دهندگان» می‌توانند از «پردازشگرهای پیام» منسوب به سازمان «VALIDATE» فراخوانی شوند و هرگونه خطای بروزیافته را اصلاح کنید.
- اگر بتوانید فراخوانی API را مستقیماً از «پردازشگر پیام» اجرا کنید، بسیار محتمل است که بتوانید API را ازطریق SmartDocs نیز اجرا کنید.
- فراخوانی API را ازطریق SmartDocs اجرا کنید و بررسی کنید که مشکل برطرف شده است یا نه.