خطای 502 را با سه مرز بررسی کنیم؛ نه با ری‌استارت همه‌چیز

منبع فنی: تعریف 502 Bad Gateway در MDN. ترتیب بررسی زیر پیشنهاد مستقل این یادداشت است.

کد 502 معمولاً می‌گوید یک دروازه یا پراکسی از بالادست پاسخ نامعتبر دریافت کرده است. این کد به‌تنهایی نمی‌گوید پایگاه داده خراب شده یا همه سرورها باید ری‌استارت شوند.

سه مرز، سه پرسش

1. کاربر تا دروازه: خطا برای کدام نام، مسیر و زمان رخ داده و آیا از چند اتصال تکرار می‌شود؟
2. دروازه تا برنامه: مقصد، پورت، نام میزبان و روش اتصال با تنظیم معتبر تطبیق دارند؟ همان لحظه در لاگ پراکسی چه ثبت شده است؟
3. داخل برنامه و وابستگی‌ها: درخواست به برنامه رسیده؟ اگر رسیده، کجا شکست خورده یا متوقف شده است؟

شناسه درخواست و زمان مشترک، نتیجه این بررسی‌ها را به هم وصل می‌کنند. فقط دیدن یک پیام قدیمی در لاگ، آن را علت درخواست فعلی نمی‌کند.

یک مثال فرضی

بعد از استقرار، آدرس مقصد پراکسی با پورت برنامه هم‌خوان نیست. خود برنامه سالم است اما مسیر دسترسی درست نیست. ری‌استارت پایگاه داده در این وضعیت، مسئله را هدف نمی‌گیرد و می‌تواند اختلال اضافه بسازد.

معیار پایان

همان مسیر کاربر را دوباره آزمایش کنید و هم‌زمان پاسخ پراکسی و برنامه را ببینید. بالا بودن پورت یا بازشدن صفحه‌ای دیگر کافی نیست. اگر تغییر لازم شد، یک عامل را عوض کنید و نتیجه و روش بازگشت را ثبت کنید.

مطالعه مکمل: پیش از ری‌استارت چه ثبت کنیم؟

بررسی منبع: 2 نوامبر 2026. مثال فرضی است؛ کد خطا جای بررسی شواهد و تنظیم همان محصول را نمی‌گیرد.