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