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