وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

API بیرونی از هاست Node.js پاسخ نمی‌دهد؛ مشکل DNS، اتصال یا TLS است؟

تشخیص خطای DNS، اتصال و TLS درخواست API در هاست Node.js و تنظیم زمان انتظار.

انتشار:
توسط تیم فنی نت‌آرام
۵ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله API بیرونی از هاست Node.js پاسخ نمی‌دهد؛ مشکل DNS، اتصال یا TLS است؟ در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
درخواست API روی لپ‌تاپ موفق است اما از هاست Node.js دیر تمام می‌شود یا خطا می‌دهد. قبل از تغییر کد، باید بدانیم شکست در پیدا کردن نام دامنه، برقراری اتصال، بررسی گواهی یا دریافت پاسخ HTTP رخ داده است. هر کدام راه‌حل متفاوتی دارند.
این آزمایش‌ها را فقط برای API مجاز و ترجیحاً endpoint سلامت بدون اطلاعات خصوصی انجام دهید. توکن، رمز و بدنه حساس را در فرمان‌ها یا گزارش‌های اشتراکی قرار ندهید.

۱. خطا و محیط واقعی برنامه را ثبت کنید

نام میزبان، پورت، زمان رخداد و کد خطا را یادداشت کنید. ENOTFOUND معمولاً به حل نام، ECONNREFUSED به رد اتصال و ETIMEDOUT به پایان مهلت اشاره دارد؛ متن کامل و زمینه همچنان مهم است. پاسخ HTTP مانند 401 یا 429 یعنی دست‌کم یک پاسخ HTTP دریافت شده و باید احراز هویت یا محدودیت درخواست را جداگانه بررسی کرد.
در Terminal یا SSH همان محیط:
کد / دستورnode --version node -p "process.execPath"
نسخه و مسیر را با محیط انتخاب‌شده در پنل مقایسه کنید. موفقیت دستور در حساب دیگر یا رایانه شخصی لزوماً مسیر شبکه و تنظیمات برنامه وب را تأیید نمی‌کند.

۲. نام دامنه را از همان محیط حل کنید

دامنه نمونه را با میزبان واقعی و عمومی API عوض کنید:
کد / دستورnode -e "require('node:dns').lookup('api.example.com', {all:true}, console.log)"
در صورت موفقیت، یک یا چند آدرس و خانواده IPv4 یا IPv6 دیده می‌شود. اگر خطای نام می‌آید، نام دامنه، تنظیم resolver سرویس و دسترسی DNS را با مدیر هاست بررسی کنید. وجود آدرس به تنهایی رسیدن اتصال یا اعتبار گواهی را ثابت نمی‌کند. در شبکه‌هایی که IPv4 و IPv6 رفتار متفاوت دارند، اختلاف مسیر را با ارائه‌دهنده بررسی کنید؛ خاموش‌کردن سراسری IPv6 بدون تشخیص مناسب نیست.

۳. اتصال و گواهی را جداگانه بسنجید

اگر curl در محیط موجود است، برای یک URL سلامت عمومی:
کد / دستورcurl -v --connect-timeout 5 --max-time 15 -o /dev/null 'https://api.example.com/health'
خروجی جزئیات نام، اتصال، TLS و وضعیت را نشان می‌دهد. ممکن است هدرها یا نشانی خصوصی در خروجی باشند؛ آن‌ها را پیش از اشتراک‌گذاری بپوشانید. --connect-timeout زمان اتصال و --max-time سقف کل این فرمان را محدود می‌کند. اگر خطای گواهی دیدید، نام میزبان، ساعت و زنجیره CA را بررسی کنید؛ از -k یا خاموش‌کردن اعتبارسنجی در برنامه برای رفع دائمی مشکل استفاده نکنید.
اگر curl موفق است ولی Node خطای TLS دارد، نسخه Node، فهرست گواهی‌ها و پراکسی احتمالی دو محیط ممکن است فرق داشته باشند. اگر اتصال رد یا قطع می‌شود، مجوز خروجی سرویس، فایروال، آدرس اجازه‌داده‌شده در API و در دسترس بودن مقصد را با مدیران مربوط مقایسه کنید. تغییر فایروال عمومی بدون شناسایی مسیر لازم نیست.
برای دیدن نتیجه مذاکره TLS در محیطی که OpenSSL و مجوز آزمون دارد، می‌توانید از openssl s_client -connect api.example.com:443 -servername api.example.com -verify_hostname api.example.com -verify_return_error استفاده کنید. نام نمونه را در هر سه بخش با میزبان واقعی عوض کنید و پس از پایان آزمون ارتباط را ببندید. این ابزار ممکن است از فهرست CA متفاوتی نسبت به Node استفاده کند؛ موفقیتش یک سرنخ است، نه اثبات سلامت تنظیم Node. اگر API روی پورت دیگری است، پورت تأییدشده را جایگزین کنید.

۴. زمان انتظار برنامه را واضح تنظیم کنید

در نسخه‌هایی که fetch و AbortController داخلی دارند، یک نمونه آزمایشی برای درخواست GET:
کد / دستورconst controller = new AbortController(); const timer = setTimeout(() => controller.abort(), 10000); fetch('https://api.example.com/health', { signal: controller.signal }) .then(response => console.log('HTTP status:', response.status)) .catch(error => console.error('Request failed:', error.name, error.cause?.code)) .finally(() => clearTimeout(timer));
دامنه نمونه را عوض کنید. این مثال فقط وضعیت پاسخ را می‌بیند و کل بدنه را پردازش نمی‌کند. اگر برنامه بدنه بزرگی می‌خواند، سیاست زمان و لغو باید تا پایان خواندن بدنه طراحی شود. در Node و کتابخانه‌های متفاوت، روش timeout فرق دارد؛ مثلاً تنظیم یک رویداد timeout در API قدیمی HTTP الزاماً درخواست را خودکار لغو نمی‌کند.
تکرار خودکار برای یک GET بی‌خطر ممکن است با فاصله و سقف محدود مناسب باشد. برای پرداخت، ثبت سفارش یا هر عملیات دارای اثر، تکرار بی‌برنامه می‌تواند کار را دوبار انجام دهد؛ به قرارداد idempotency همان API نیاز دارید.
اگر پاسخ ۴۲۹ دریافت می‌کنید، مقدار Retry-After را در صورت وجود با راهنمای سرویس تطبیق دهید و تعداد درخواست را کاهش دهید. افزایش تعداد تلاش‌های هم‌زمان معمولاً محدودیت طرف مقابل را بدتر می‌کند.

۵. نتیجه را در برنامه واقعی تأیید کنید

پس از اصلاح علت، همان درخواست مجاز را از محیط برنامه و سپس از مسیر واقعی سایت امتحان کنید. وضعیت موفق، زمان پاسخ و گزارش بدون رمز را با قبل مقایسه کنید. اگر قطع فقط پس از بیکاری اتصال اتفاق می‌افتد، راهنمای ECONNRESET و keep-alive مسئله نزدیک ولی متفاوتی را توضیح می‌دهد.
مشخصات هاست Node.js نت‌آرام و جزئیات مدیریت درخواست در مستندات Node.js در دسترس است.
برچسب‌ها:
اشتراک‌گذاری:
لینکدینتلگرامایکس

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام