رفع خطای 500 در هاست پایتون؛ از لاگ تا WSGI و ASGI
برای تشخیص سریع، یک درخواست کمخطر را بازتولید کنید و زمان آن را با لاگ برنامه تطبیق دهید. خرابی همه مسیرهای پویا معمولاً بررسی نقطه ورود و محیط اجرا را مق…
برای تشخیص سریع، یک درخواست کمخطر را بازتولید کنید و زمان آن را با لاگ برنامه تطبیق دهید. خرابی همه مسیرهای پویا معمولاً بررسی نقطه ورود و محیط اجرا را مقدم میکند؛ خرابی یک مسیر خاص، بررسی همان استثنا را.
فهرست مطالب
- از روی دامنه خرابی شروع کنید
- لاگ برنامه و وبسرور را کنار هم بخوانید
- نقطه ورود، مفسر و محیط واقعی را کنترل کنید
- متغیرهای محیطی، فایل و پایگاه داده را جدا تشخیص دهید
- چگونه یک آزمون سلامت کوچک و قابل اعتماد طراحی کنیم؟
- چه زمانی برگردیم و چه زمانی همان نسخه را اصلاح کنیم؟
- نمونههای عملی: خطا را با یک تغییر کوچک جدا کنید
- خرید یا ارتقای هاست پایتون: سؤالهایی که باید پیش از انتقال بپرسید
- پرسشهای متداول
- جمعبندی
از روی دامنه خرابی شروع کنید
برای رفع خطای 500 در هاست پایتون، ابتدا یک درخواست کمخطر را بازتولید کنید، زمان و مسیر آن را یادداشت کنید و همان زمان را در لاگ وبسرور و برنامه پیدا کنید. اگر هیچ مسیر پویایی باز نمیشود، از ورودی برنامه، مفسر و تنظیمات شروع کنید. اگر فقط یک مسیر خراب است، نخست استثنای همان مسیر و وابستگیهایی مثل پایگاه داده، فایل یا سرویس بیرونی را بررسی کنید. پاسخ 500 میگوید پردازش درخواست به خطای داخلی برخورد کرده است؛ بهتنهایی نمیگوید کدام جزء خراب است. روشن کردن DEBUG روی دامنه عمومی یا نصب چندباره وابستگیها قبل از خواندن لاگ، معمولاً شواهد را کمتر و ریسک را بیشتر میکند.
مثال این راهنما یک سامانه ثبت درخواست خدمات است. صفحه معرفی باز میشود، ولی کاربر هنگام مشاهده وضعیت درخواست 500 میگیرد. مدیر سایت ابتدا تصور میکند برنامه اصلاً اجرا نشده، اما صفحه معرفی به شکل فایل ایستا از لایه دیگری سرو میشود. یک مسیر پویای سبک به درخواست پاسخ میدهد و در لاگ برنامه برای مشاهده وضعیت، خطای اتصال به پایگاه داده ثبت شده است. نتیجه این نیست که هاست حتماً سالم است؛ نتیجه این است که عیبیابی منطقی باید از دسترسی همان فرایند به پایگاه داده آغاز شود. عوض کردن WSGI با ASGI در این مرحله چیزی درباره اتصال داده روشن نمیکند.
اول معلوم کنید کدام درخواست به کدام لایه رسیده است. سپس جزئی از برنامه را تغییر دهید که شواهد همان لایه به آن اشاره میکند.
ورودی کنترلشده و گزارش کوتاه بسازید
به جای چند بار کلیک روی دکمه ثبت، یک مسیر فقطخواندنی یا داده آزمایشی انتخاب کنید. یک URL دقیق، روش درخواست، زمان با منطقه زمانی، نام نسخه استقرار و کد پاسخ را ثبت کنید. اگر سامانه شناسه درخواست دارد آن را بردارید؛ اگر ندارد با ثبت یک زمان دقیق و اجتناب از چند درخواست همزمان، پیدا کردن رخداد را ساده کنید. از ذخیره کل هدرها، کوکیها، داده مشتری و رشته اتصال در گزارش خودداری کنید. در یک فرم آنلاین، کاربر ممکن است پیام خطا ببیند در حالی که رکورد قبلاً ایجاد شده است؛ تکرار دستی همان فرایند روی داده واقعی میتواند رکورد تکراری بسازد.
قبل از اینکه مسئله را به هاست یا برنامه نسبت دهید، حدود مسئله را تعریف کنید. آیا دامنه و زیردامنه هر دو همان نسخه برنامه را نشان میدهند؟ آیا خطا با نشست ناشناس هم دیده میشود؟ آیا هر درخواست، نخستین درخواست پس از راهاندازی یا فقط یک نوع فایل موجب خطا میشود؟ آیا از ساعت مشخصی شروع شده، و در آن ساعت تغییری در وابستگی، عملیات پایگاه داده یا فایل تنظیمات رخ داده است؟ هر پاسخ یک فرضیه را قویتر میکند، ولی بدون لاگ قطعی نیست. اگر از ابزار بیرونی وضعیت صفحه را میخوانید، مراقب باشید صفحه خطای کششده، ریدایرکت یا ورود به پنل را با پاسخ مستقیم برنامه اشتباه نگیرید.
| نشانه | اولین فرضیه قابل آزمون | شاهد لازم |
|---|---|---|
| همه مسیرهای پویا خطا دارند | برنامه یا فرایند اجرا راه نیفتاده است | پیام شروع و مسیر ورودی |
| فقط فرم یا گزارش خراب است | خطای داخل مسیر یا اتصال بیرونی | رد استثنا برای همان درخواست |
| تصاویر باز میشوند اما API نه | لایه فایل از اجرای برنامه جداست | سلامت یک مسیر پویای سبک |
| شروع پس از انتشار کد | عدم تطابق نسخه یا تنظیم | شناسه انتشار و اولین خطا |
| تکرار در ساعت شلوغ | ظرفیت یا وابستگی کند | زمان درخواست و داده همان بازه |
500 را با 502 و 504 یکی نگیرید
در طراحی متداول، 502 میتواند نشانه دریافت پاسخ نامعتبر از سرویس بالادست و 504 نشانه پایان مهلت انتظار واسطه باشد؛ اما سفارشیسازی خطاها ممکن است ظاهر را عوض کند. کد واقعی را ببینید و بررسی کنید پاسخ را کدام لایه تولید کرده است. اگر واسطه میگوید به برنامه وصل نشده، هنوز معلوم نیست چرا: فرایند ممکن است آغاز نشده، سوکت یا پورت ممکن است اشتباه باشد، یا واسطه تنظیم ناسازگاری داشته باشد. در مقابل، اگر خود برنامه استثنا را ثبت کرده و پاسخ 500 داده، تمرکز بر مسیر ورود وبسرور جهت درستی نیست. همین تمایز مسیر سؤال از تیم برنامه یا پشتیبانی را تغییر میدهد.
لاگ برنامه و وبسرور را کنار هم بخوانید
لاگ درست را پیدا کنید
مسیر فایل لاگ را از رابط مدیریت، تنظیمات ابزار استقرار یا مستندات میزبان پیدا کنید؛ یک مسیر رایج در اینترنت الزاماً روی حساب شما وجود ندارد. بعضی محیطها خروجی استاندارد برنامه را جمع میکنند، برخی لاگ شروع فرایند را از لاگ درخواست جدا نگه میدارند، و برخی دسترسی مستقیم به لاگ واسط را فقط به پشتیبانی میدهند. اگر یک پیام خطای عمومی میبینید ولی لاگ خالی است، بهخودیخود نتیجه نگیرید هیچ استثنایی رخ نداده است. ممکن است فایل دیگری را نگاه کنید، برنامه به آن مسیر نرسیده یا زمانهای ثبت در دو سامانه فرق داشته باشند.
در لاگ وب معمولاً معلوم میشود درخواست به کدام نشانی و با چه وضعیت پاسخ رسیده است؛ لاگ برنامه درباره استثنا، فایل و محل شکست اطلاعات بیشتری میدهد. برای پیدا کردن علت، اولین پیام مربوط به زمان شروع اختلال را بخوانید. اگر بعد از شکست اول فرایند چند بار بازنشانی شده باشد، آخرین پیام ممکن است فقط نتیجه خرابی قبلی را تکرار کند. یک خط «برنامه بارگذاری نشد» را از استثنایی که همان بارگذاری را متوقف کرده جدا کنید. اگر خطای دوم میگوید مسیر لاگ قابل نوشتن نیست، آن را حل کنید تا بتوانید شاهد اصلی را ببینید، نه اینکه همه خطاها را به مجوز یک فایل ربط دهید.
تشخیص خطای برنامه بدون افشای جزئیات
در تولید، خود پیام عمومی باید کوتاه باشد و رد کامل استثنا به کانال محدود برود. برای Django سازوکارهای تنظیمات تولید را در چکلیست رسمی استقرار Django ببینید و برای Flask به مستندات ثبت رخداد مراجعه کنید. اگر برای بازتولید به جزئیات بیشتری نیاز است، در محیط محصور و با داده نمونه سراغ آن بروید. تنظیم DEBUG، مفسر تعاملی و سرور توسعه برای دامنه در دسترس مشتری کار مناسبی نیستند. در تیکت هم فقط بخشی از پیام را بفرستید که برای شناسایی مشکل لازم است.
رد استثنا را از آخر به اول بخوانید
ابتدا نوع استثنا و توضیح کوتاه آن را ببینید، سپس نخستین فایل متعلق به برنامه خودتان را پیدا کنید. یک خطا ممکن است در کتابخانه آخر ظاهر شود ولی ورودی لازم از فایل تنظیمات یا کد شما نیامده باشد. اگر همان زمان چند پیام دارید، زنجیره علت و پیام خطای پوشاننده را از هم جدا کنید. نام بسته، نسخه برنامه و مسیری که به خطا رسیده را یادداشت کنید. برای یک خطای خواندن متغیر، لازم نیست مقدار واقعی آن را در گزارش نمایش دهید.
مثال: لاگ ورودی با خطای مسیر متفاوت است
فرض کنید زمان ۱۲:۰۱ یک خطای وارد کردن ماژول دارید و زمان ۱۲:۰۵ یک خطای پایگاه داده. میان این دو تیم مسیر ورودی را اصلاح کرده است. دیگر نباید خطای دوم را با برگشت مسیر ورودی رفع کنید. در تیکت بنویسید «در نسخه فعلی مسیر سلامت پاسخ میدهد ولی مسیر درخواستها در اتصال داده خطا دارد». بررسی نقطهبهنقطه شما را از کاری که قبلاً حل شده دور نگه میدارد.
نقطه ورود، مفسر و محیط واقعی را کنترل کنید
WSGI و ASGI قرارداد اجرا هستند، نه تنظیم تزئینی
اگر برنامه در زمان بارگذاری خطا میدهد، مشخص کنید میزبان واقعاً چه چیزی را وارد میکند. در نمونه Django ممکن است شیء application از ماژول wsgi یا asgi پروژه خوانده شود. در بعضی استقرارهای Flask، سرور مستقیم شیء app را میخواند و در بعضی دیگر برنامه ابتدا از factory ساخته میشود. رشته دقیق معرفی شیء، نحو پیکربندی و وجود فایل ورودی واسط به ابزار اجرا وابستهاند؛ نمونه یک پنل را در پنل دیگر کپی نکنید. پیش از تغییر، نام ماژول، نام شیء، مسیر پروژه و پوشه کاری موجود را با تنظیم ثبتشده در پنل تطبیق دهید. راهنمای رسمی استقرار Django هر دو رابط را توضیح میدهد؛ اما پشتیبانی عملی از رابط انتخابی را باید برای سرویس خودتان بررسی کنید.
یک رخداد نمونه این است که پروژه در رایانه توسعه از مسیر بالاتری اجرا میشود ولی فایل ورودی در هاست از پوشه دیگری شروع میکند. بسته پروژه روی مسیر جستوجوی مفسر نیست یا اسم پوشه با نامی که ابزار استقرار وارد میکند فرق دارد. افزودن چند مسیر به صورت حدسی، راهحل را به ساختار فعلی ماشین وابسته میکند. اول ببینید ریشه پروژه در پیکربندی چیست و آیا برنامه با همان ریشه و همان مفسر در محیط آزمایش اجرا میشود. نام شاخه انتشار را کنار تنظیم مسیر بنویسید تا روشن شود نسخه جدید واقعاً همان جایی قرار گرفته است که فرایند میخواند.
محیط محلی و محیط فرایند وب را یکی فرض نکنید
ترمینال میتواند به مفسری وصل باشد که ربطی به برنامه عمومی ندارد. در محیط مجازی، مستندات رسمی Python درباره venv توضیح میدهد که فعالسازی محیط مقدار مسیر پوسته را تغییر میدهد؛ استفاده از مسیر صریح مفسر نیز ممکن است. برای تشخیص، مفسر و مسیر بستهها را در یک آزمایش امن و از داخل محیط درست بررسی کنید. اگر اجازه مشاهده مستقیم فرایند وب ندارید، از اطلاعات پیکربندی پنل و لاگ شروع استفاده کنید. موفق بودن یک فرمان عام با نام python یا pip، نسخهای را که وب اجرا میکند اثبات نمیکند.
فرض کنید نصب وابستگی در ترمینال موفق است و پنل باز هم خطای نبود ماژول میدهد. دو سؤال بپرسید: نصب برای همان مفسر بوده؟ و نامی که در دستور import میبینید با نام بسته نصبی چه ارتباطی دارد؟ همه توزیعها با همان نامی که وارد میشوند نصب نمیشوند. اگر با پنل محیط مجازی ساختهاید، از تنظیمات و مسیر معتبر همان برنامه کمک بگیرید. نصب دوباره همه کتابخانهها روی کل حساب، تشخیص را مشکل میکند و ممکن است محیط پروژه دیگر را عوض کند. برای اصل انتقال و بازسازی محیط، چکلیست مهاجرت پروژه پایتون مکمل این مرحله است.
بستهها را از روی نسخه استقرار مدیریت کنید
فهرست وابستگی باید به نسخهای تعلق داشته باشد که واقعاً در هاست اجراست. اگر فایل requirements از شاخه متفاوت آمده باشد، استقرار موفق از نظر کپی فایلها هنوز میتواند در زمان import شکست بخورد. ابتدا نام نسخه، مسیر فایل، نسخه مفسر و خروجی کنترل وابستگی را در محیط آزمایش ثبت کنید. برای یک بسته بومی ممکن است توزیع از پیش ساختهشده برای مفسر یا معماری هدف پیدا نشود یا زمان نصب به ساخت با ابزارهای سامانه نیاز داشته باشد. پیام نصب را از استثنای اجرای برنامه جدا کنید. اگر ساخت نیازمند کتابخانه یا اختیار سیستمی است، آن را از سوی ارائهدهنده تأیید کنید و وانمود نکنید همه حسابهای اشتراکی چنین دسترسیای دارند.
یک تغییر چندگانه را به تغییرهای کوچک تقسیم کنید. وقتی نسخه مفسر، فریمورک و فایل تنظیمات را یکجا جایگزین کنید، پس از خرابی حداقل سه فرضیه دارید. اگر هر تغییر در محیط مستقل از نظر مسیر شروع، وارد کردن ماژول و یک درخواست آزمایشی سنجیده شود، نقطه شکست محدودتر میشود. بهخصوص در پروژهای که به سازگاری بسته با نسخه معین وابسته است، نسخه کارکرده را با شماره انتشار نگه دارید و نتیجه را روی داده آزمایشی بنویسید. بازگرداندن کد به نسخه قبل زمانی کافی است که محیط و تغییرهای داده همچنان سازگار باشند.
| مشاهده | بررسی پیشنهادی | از چه کار عجولانه پرهیز کنیم |
|---|---|---|
| ماژول پروژه بارگذاری نمیشود | نام ماژول و پوشه کاری فرایند وب | تغییر حدسی همزمان چند مسیر |
| بسته در ترمینال هست و در وب نیست | مفسر و محیط مجازی هر دو مسیر | نصب بسته در محیط عمومی حساب |
| خطا بعد از تغییر نسخه مفسر | سازگاری بستهها و نتیجه نصب روی نسخه هدف | نادیده گرفتن پیغام نصب وابستگی |
| برنامه در توسعه سالم است | ابزار اجرای تولید و محیط واقعی | روشن کردن سرور توسعه روی دامنه عمومی |
متغیرهای محیطی، فایل و پایگاه داده را جدا تشخیص دهید
نام و وجود متغیر را بررسی کنید، نه مقدار محرمانه را
فرایند وب الزاماً همان متغیرهای پوسته کاربر را نمیگیرد. اگر برنامه برای شروع به یک متغیر نیاز دارد، ابتدا مشخص کنید در کدام بخش پیکربندی باید وارد شود و آیا تغییر پس از بارگذاری مجدد همان برنامه اثر میکند. وجود کلید را با مشاهده امن در محیط آزمایش یا رفتار قابل ثبت برنامه کنترل کنید، نه با چاپ کل محیط. کلیدهای محرمانه و گذرواژهها نباید در HTML، عکس پنل، پیام حمایت فنی یا خروجی ابزار تشخیص عمومی ظاهر شوند. برای نامهای غیرمحرمانه مثل نام محیط، یک نشانه مشخص به کار ببرید تا از اشتباه گرفتن تولید و آزمایش جلوگیری شود.
اگر خطا فقط بعد از استقرار و پیش از اولین پاسخ به وجود آمده، شاید برنامه هنگام بارگذاری تنظیمات الزام مهمی را بررسی میکند. یک پیام روشن مثل «نام متغیر لازم تعریف نشده» از چاپ تنظیمات کامل مفیدتر است. اگر همزمان چند محیط را دارید، وجود یک فایل خصوصی در توسعه دلیل نمیشود همان فایل در تولید خوانده شود. روش بارگذاری، محل فایل و سیاست نگهداری رازها را از اسناد پروژه و میزبان خودتان بخوانید. برای بازگشت، پیکربندی کارکرده را با کنترل دسترسی ثبت کنید و هنگام انتقال نسخه مطمئن شوید هیچ فایل تستی به دامنه عمومی راه پیدا نکرده است.
خطای دسترسی فایل را با دسترسی بیحد حل نکنید
در عیبیابی فایل ابتدا معلوم کنید آیا برنامه قصد خواندن دارد یا نوشتن، مسیر مورد انتظار واقعی کجاست و هویت فرایند چیست. مسیر نسبی با پوشه کاری شروع میشود و ممکن است زیر پوشه متفاوتی قرار بگیرد. مجوزی که به کاربر ورود اجازه میدهد نیز لزوماً به هویت فرایند وب تعلق ندارد. اگر مسیر در محدوده حساب شماست، با روش رسمی مالکیت و مجوز لازم را اصلاح کنید؛ اگر در محدوده مدیریت میزبان است، از پشتیبانی بخواهید وضعیت ارزیابی شود. باز کردن دسترسی همه کاربران برای پنهان کردن خطا، هم نتیجه تشخیص را مبهم میکند و هم داده مردم را در معرض خطر میگذارد.
اگر مشکل فقط تصویر و CSS است، ممکن است از مسیر مسیریابی فایل ایستا باشد نه شروع خود برنامه. برای تشخیص تخصصیتر از راهنمای فایل Static و Media در Django استفاده کنید. حالتی را هم در نظر بگیرید که برنامه صفحه را میسازد ولی هنگام ساخت فایل گزارش به پوشه غایب میرسد. آن وقت پاسخ سایر مسیرها شاهد سالم بودن آغاز فرایند است، نه دلیلی بر سالم بودن همه دسترسیها. نمونه با یک فایل بیخطر و یک پوشه مجاز بسازید تا علت با کمترین تغییر دیده شود.
دسترسی پایگاه داده را از داخل محیط هدف بسنجید
باز شدن ابزار مدیریت پایگاه داده برای مدیر سایت لزوماً به معنی دسترسی فرایند وب با حساب خودش نیست. نام مقصد، پایگاه داده، مسیر شبکه و اعتبارنامه برنامه باید با روش تأییدشده همان محیط همخوان باشند. اگر خطا به دسترسی مربوط است، به همه نقشها مجوز گسترده ندهید تا نتیجه مشخص شود؛ تعیین کنید برنامه در مسیر معیوب دقیقاً چه عملی میخواهد انجام دهد. گاهی مسیر خواندن سالم است، ولی کار در حال ثبت به مجوز یا ساختاری نیاز دارد که در نسخه فعلی فراهم نشده است. در یک تست کمخطر، خواندن و نوشتن را با داده مصنوعی و در محیط جداگانه بسنجید.
خطای «جدول پیدا نشد» ممکن است از اتصال به پایگاه اشتباه یا عقب ماندن مهاجرت داده ناشی شود. اول بررسی کنید نام مقصد و نسخه داده چیست و آیا اجرای تغییر با سیاست انتشار هماهنگ بوده است. روی داده واقعی فقط برای دیدن نتیجه، مهاجرت ساختاری ناشناخته اجرا نکنید. پیش از هر تغییر، وضعیت نسخه و قابلیت بازگشت را روشن کنید. اگر تیم داده و تیم برنامه جدا هستند، شماره انتشار و وضعیت تغییرهای سازگار یا ناسازگار را بین آنها مشترک کنید. بازگرداندن فایلهای پایتون اگر ساختار داده با نسخه قبلی همخوان نباشد میتواند خطای تازهای به وجود آورد.
سرویس بیرونی را با داده و زمانبندی واقعی جدا کنید
فرض کنید تنها زمانی خطا دارید که برنامه اطلاعاتی را از یک سرویس بیرونی میخواند. اگر مسیر سلامت مستقل از آن سرویس پاسخ میدهد و لاگ هم زمان انتظار اتصال بیرونی نشان میدهد، نیازی نیست فوراً محیط مجازی را بازسازی کنید. یک تماس کنترلشده طبق شرایط سرویس و با حساب آزمایشی میتواند روشن کند مسئله از نشانی درخواست، نوع پاسخ یا دسترسی است. برای درخواستهایی که پیام میفرستند، هزینه ایجاد میکنند یا داده را تغییر میدهند، تکرار را فقط در محیط آزمایش انجام دهید. از تست درخواست عمومی خودتان به نشانیهای دیگران برای کشف مشکل خودداری کنید.
گاهی برنامه برای هر درخواست مشتری منتظر سرویس بیرونی میماند و آن خدمت خطا میدهد، اما کاربر فقط صفحه عمومی 500 را میبیند. بهتر است تفاوت «فرایند برنامه از کار افتاده» با «یک وابستگی لازم اکنون پاسخ قابل استفاده ندارد» در لاگ و ابزار مشاهده آشکار باشد. در طراحی برنامه، تصمیم بگیرید که کدام خطا قابل نمایش با پیام مناسب است، کدام عملیات باید متوقف شود و کدام نتیجه میتواند در پنل در انتظار بماند. یک صفحه سلامت که نتیجه شبکه، نسخه و تنظیمات را برای عموم چاپ کند جایگزین مشاهده امن نیست.
چگونه یک آزمون سلامت کوچک و قابل اعتماد طراحی کنیم؟
سلامت راهاندازی را از سلامت کار واقعی جدا کنید
ابتدا بررسی کنید فرایند میتواند شروع شود و یک مسیر سبک درخواست را پاسخ دهد. این آزمون تنها میگوید چارچوب ورود و اجرای بخشی از برنامه آماده است. سپس مسیر نماینده کسبوکار را امتحان کنید: در سامانه ثبت درخواست، بازیابی یک رکورد مصنوعی، و در ابزار گزارش، گرفتن یک خروجی کنترلشده. چهبسا نسخه اصلی برای ارائه صفحه آماده باشد ولی برای اتصال به داده لازم راهی نداشته باشد. اگر فقط آزمون نخست را داشته باشید، سبز شدن آن بعد از انتشار باعث میشود دیرتر متوجه خرابی شوید. اگر فقط آزمون دوم را دارید، یافتن اینکه فرایند اصلاً شروع شده یا نه سختتر خواهد بود.
اطلاعات مورد نیاز برای تشخیص باید به دست اپراتور برسد، نه هر کسی که URL را پیدا میکند. پاسخ عمومی سبک میتواند فقط نتیجهای کوتاه بدهد، و گزارش دقیقتر در کانال محدود نگهداری شود. مسیر آزمایش نباید همه سفارشهای واقعی را پیمایش کند، به سرویس بیرونی هزینه تحمیل کند یا هر بار در داده عملیاتی بنویسد. در تست دورهای بهتر است تعداد و فاصله درخواستها متناسب با کاربرد باشد. برای محیط توسعه یک نسخه مستقل از آزمون بسازید که به نشانی تولید متصل نباشد تا اجرای تکراری روی رایانه تیم به مشتری واقعی اثر نگذارد.
نمونه یک خواننده لاگ و یک درخواست در سه زمان
در زمان صفر، نسخه قبلی را ثبت میکنید و درخواست سبک موفق است. بلافاصله پس از انتشار، مسیر سبک 500 میدهد و لاگ شروع فقدان یک متغیر غیرمحرمانه را نشان میدهد. پس از اصلاح تنظیم و راهاندازی دوباره طبق روش میزبان، مسیر سبک پاسخ میدهد. سپس مسیر اصلی گزارش 500 میدهد، اما این بار لاگ در مرحله دسترسی فایل است. اگر فقط خروجی آخر را بخوانید شاید فکر کنید همه تلاشها بینتیجه بوده است. ثبت جداگانه سه زمان نشان میدهد دو مشکل مختلف دارید و عیب نخست حل شده است. برای مرحله دوم نسخه قبلی تنظیم را بیجهت برنگردانید؛ مالکیت و مسیر مرتبط با گزارش را بررسی کنید.
در یک پروژه کوچک، همین سناریو را به شکل برگه تحویل نگه دارید. ستون اول زمان و نام محیط، ستون دوم آخرین تغییر، ستون سوم آزمون و نتیجه، و ستون چهارم پیام کوتاه کلیدی باشد. این مستند نباید شبیه دفترچه همه اتفاقات سرور شود؛ یک یا دو ردیف برای هر استقرار هم کافی است اگر شواهد لازم را داشته باشد. برای استقرارهای مکرر، گزارش آزمونهای خط پایه را با نسخه منبع تطبیق دهید. اگر گاهی رفتار در نخستین درخواست متفاوت است، یک تست شروع سرد را هم از تست بعد از آماده شدن جدا کنید.
| مرحله آزمون | نمونه نتیجه | محدوده استنباط |
|---|---|---|
| بارگذاری مفسر و ماژول | اجرای برنامه آغاز میشود | سازگاری همه مسیرها هنوز ثابت نیست |
| مسیر سبک | کد پاسخ مناسب میدهد | ناشی از سلامت داده تجاری نیست |
| مسیر واقعی فقطخواندنی | رکورد نمونه درست خوانده میشود | عملیات نوشتن جداگانه آزمایش شود |
| تست پس از بازگشت | دو مسیر کلیدی دوباره سالماند | مراقبت از رخدادهای تاخیری ادامه یابد |
چه زمانی برگردیم و چه زمانی همان نسخه را اصلاح کنیم؟
اگر مشکل به یک فرایند حیاتی مانند ثبت سفارش رسیده است، محدود کردن خسارت مقدم بر تشخیص کامل در محیط واقعی است. تاریخچه انتشار را ببینید و مشخص کنید کدام فایل، پیکربندی و وابستگی با هم کار میکردند. اگر بازگشت نسخه برنامه با وضعیت داده سازگار است و رویه آن را از قبل دارید، بازگشت کنترلشده میتواند فرصت تحلیل در آزمایشگاه بدهد. اگر نسخه قدیمی با داده جدید ناسازگار است، ابتدا با مسئول برنامه و داده هماهنگ کنید. برگرداندن کورکورانه کد به امید برگرداندن خودکار پایگاه داده میتواند راه بازیابی را سختتر کند.
در تغییرهای کوچک که علت و اثر روشن است، ممکن است اصلاح تنظیم کمخطرتر باشد. برای نمونه یک نام ماژول اشتباه را در نسخه آزمایشی اصلاح کنید، نتیجه را ببینید و همان مقدار را طبق رویه منتشر کنید. اگر همزمان قرائن متناقض دارید، چند کار اصلاحی را بدون ثبت انجام ندهید. بعد از هر اقدام، همان درخواست و زمان جدید را بررسی کنید. پیش از پایان رخداد، علاوه بر مرورگر، یکی از خروجیهای برنامه را بسنجید تا سالم شدن خدمت به یک پیام کلی یا سبز شدن پنل محدود نماند.
نمونههای عملی: خطا را با یک تغییر کوچک جدا کنید
نمونه Django: برنامه بالا میآید ولی پنل سفارش خطا دارد
تیم توسعه بهتازگی فیلتر جدیدی به پنل سفارش اضافه کرده است. صفحه اصلی و ورود مدیر کار میکند، اما فیلتر وقتی مقدار خاصی را دریافت میکند به خطای داخلی میرسد. دو آزمون بیخطر تعریف کنید: مشاهده فهرست بدون فیلتر و اجرای همان فیلتر روی داده ساختگی. اگر اولی سالم و دومی خراب است، لازم نیست همه تنظیمات هاست را تکان دهید. زمان کلیک را کنار خطای همان مسیر بگذارید و ورودی و شاخه منطقی را بررسی کنید. اگر پیام خطا درباره ساختار جدول است، شماره تغییر داده را با نسخه برنامه تطبیق دهید. اگر متن به تبدیل مقدار اشاره دارد، حالت مرزی ورودی را در تست داخلی بازتولید کنید. اعداد سفارش یا اطلاعات مشتری را به ابزار عمومی تحلیل نفرستید.
پایان درست این کار فقط باز شدن فهرست نیست. به مسیر فیلتر با داده نامعتبر نیز سر بزنید تا پاسخ مناسب را ببینید؛ یک تغییر که همه خطاها را پنهان کند میتواند داده ناسالم را وارد سامانه کند. یک مورد بررسی بدون تطابق هم اضافه کنید تا فیلتر بدون نتیجه، به اشتباه خطا نشان ندهد. این روش را بعد از هر انتشار تنها برای مسیرهایی که ریسک تجاری دارند تکرار کنید و برای مسیرهای کماهمیت تناسب هزینه آزمون و خطر را در نظر بگیرید.
نمونه Flask: اجرا در لپتاپ موفق است ولی بعد از انتقال پاسخ نمیدهد
در محیط محلی برنامه با فرمان توسعه اجرا میشود. در محیط تولید، ابزار استقرار قرار است یک شیء برنامه را از بستهای خاص وارد کند. نام بسته هنگام کپی پروژه عوض شده و پوشه کاری نیز فرق دارد. اگر لاگ همان لحظه شروع از نبود ماژول شکایت میکند، قرارداد ورودی از وضعیت درخواستهای تجاری مهمتر است. در محیط جدا بررسی کنید که ابزار نصب شده برنامه را از مسیر ثبتشده و با کاربر مجاز بار میکند. سپس یک درخواست سبک را بعد از اعمال اصلاح بررسی کنید. اگر مشکل حل شد، مستندات پروژه را بهروز کنید تا تجهیز بعدی دوباره نامی را که فقط روی لپتاپ کار میکرد بازنگرداند.
بعضی پروژهها هنگام ساخت شیء برنامه، پیکربندی یا اتصال لازم را هم میخوانند. موفق بودن وارد کردن بسته بهتنهایی ثابت نمیکند که مرحله ساخت برنامه کامل است. در تست محصور، این دو را جدا بررسی کنید. اگر کارخانه برنامه تنظیم را دریافت میکند اما وابستگی آزمایشی ندارد، مسئله را با داده غیرعملیاتی بازسازی کنید. برای اجرای تولید، مستندات رسمی Flask به انتخاب سرور مناسب اشاره دارد. این مستندات را با ابزار تأییدشده میزبان تطبیق دهید؛ هیچ ضرورتی ندارد برای رفع یک اشتباه در مسیر، توسعهدهنده به کنترل کامل کل سرور دسترسی بگیرد.
نمونه خطای فایل: بارگذاری موفق ولی لینک دریافت گزارش خطا دارد
برنامه اعلام میکند فایل بهدرستی آماده شده است، اما فقط هنگام دریافت گزارش پاسخ 500 میگیرید. نخست مشخص کنید کدام بخش حکم منبع اصلی وضعیت را دارد: رکورد کار در پایگاه داده، فایل روی دیسک یا خروجی یک ابزار جدا. اگر فایل از مسیر دیگری ساخته شده، برنامه وب ممکن است به آن دسترسی نداشته باشد. اگر مسیر نسبی با پوشه کاری جدید تغییر کرده، به محل درست برگردید و دسترسی را محدود به هویت فرایند لازم نگه دارید. اگر فایل اصلاً ساخته نشده، مسئله به کارگر تولید گزارش برمیگردد. این سه حالت ظاهراً همان پیام کاربر را تولید میکنند ولی درمان متفاوتی دارند.
شواهد کافی برای گزارش و تحویل
برای هر نمونه یک گزارش کوتاه بسازید: آخرین زمان سالم بودن، اولین زمان خطا، گستره مسیرها، یک شاهد بدون اطلاعات خصوصی، تغییر انجامشده و نتیجه آزمون دوباره. برای پشتیبانی هاست مهم است بدانند از پنل چه روشی برای اجرا فعال است و آیا عیب قبل از ورود درخواست به برنامه دیده میشود. برای تیم توسعه مهم است بدانند کدام فایل و کدام ورودی سالم نبوده است. دو گزارش مستقل لازم نیست اگر همان اطلاعات با دسترسی درست در اختیار دو تیم قرار گیرد. اگر تیم هنوز منشأ خطا را قطعی نمیداند، در گزارش بین مشاهده و برداشت فرق بگذارید.
خطاهای گذرا را با یک بازه مشاهده بررسی کنید
اگر بعد از راهاندازی دوباره برای چند دقیقه خطایی نمیبینید، این نشانه مفید است ولی علت را ثابت نمیکند. زمان بازگشت خطا را با نخستین درخواست بعد از دوره بیکاری، کار دورهای سنگین، شروع ارسال گزارشها یا تغییر وضعیت پایگاه داده تطبیق دهید. برای مثال فرض کنید ربات و وبسایت روی یک حساب مشترک هر ساعت فایل تولید میکنند. اگر همان لحظه درخواستهای نمایش گزارش کند میشوند و زمان انتظار به پایان میرسد، ممکن است اندازه کار همزمان نیاز به بازبینی داشته باشد. اگر اولین خطا حتی در ساعت خلوت و قبل از اجرای آن کار ثبت میشود، فرضیه وابستگی به بار اعتبار کمتری دارد. به جای بالا بردن همه محدودیتها، آن بخش از کار را که به استناد داده فشار وارد میکند جدا شناسایی کنید.
برای یافتن اختلاف زمان، در گزارش مشخص کنید ساعت تیم فنی با ساعت لاگ همخوان است یا داده یکی از منابع به وقت جهانی نمایش داده میشود. یک اختلاف ثابت زمانی گاهی باعث میشود پیغام مربوط به انتشار قبلی را به درخواست تازه نسبت دهید. اگر شناسه درخواست در هر دو لایه ثبت شده، آن را مبنا قرار دهید و ساعت را برای یافتن محدوده بهکار ببرید. اگر این شناسه وجود ندارد، در بازهای خلوت یک درخواست آزمایشی منفرد بفرستید و نتیجه را پیگیری کنید. این روش سادهتر از روشن کردن همزمان چند حالت ثبت جزئیات در محیط اصلی است.
هزینه تشخیص را هنگام انتخاب میزبان حساب کنید
فرض کنید دو گزینه هر دو امکان اجرای فریمورک را دارند. در گزینه اول پیدا کردن لاگ و تأیید نسخه نصبشده با رویه مشخص خودتان ممکن است؛ در گزینه دوم همان کار مستلزم هماهنگی طولانی در هر انتشار است. در پروژهای که هفتهای چند بار تغییر میکند، این تفاوت میتواند برای کار تیم مهم باشد، حتی اگر یک گزینه از لحاظ منابع روی کاغذ بزرگتر به نظر برسد. پیش از انتقال، روی نمونه کوچکی بپرسید چگونه بتوان همان نسخهای را که اجراست تشخیص داد، تغییر محیط را اعمال کرد و اگر خطا رخ داد بدون به خطر انداختن رازهای پروژه شاهد معتبر ارائه کرد.
یک سؤال خوب قبل از خرید این است: «اگر فریمورک از ترمینال آغاز شود ولی دامنه 500 بدهد، چه اطلاعاتی برای تفکیک مسیر برنامه از محیط وب در اختیار دارم؟» پاسخ به این سؤال درباره فرایند پشتیبانی و دسترسی عملی چیز بیشتری میگوید تا فهرست طولانی ویژگیها. این مسئله را با روش تهیه نسخه پشتیبان و مدت زمانی که تیم شما برای آزمون پس از هر انتشار اختصاص میدهد مقایسه کنید. هدف پیدا کردن هاستی نیست که بگوید شما هیچوقت خطا نمیبینید؛ هدف انتخاب محیطی است که وقتی خطا رخ داد بتوان دامنه و علت آن را با حداقل اثر روی کاربران پیدا کرد.
خرید یا ارتقای هاست پایتون: سؤالهایی که باید پیش از انتقال بپرسید
یک هاست برای پروژه پایتون زمانی انتخاب معقول است که نسخه اجرا، روش بارگذاری و امکان مشاهده خطا با معماری واقعی برنامه همخوان باشد. اگر فقط یک برنامه وب ساده دارید، بررسی پشتیبانی از روش اجرایی و نسخه مفسر ممکن است کافی باشد. اگر پردازش پسزمینه، اتصال ویژه داده، یا ساخت بسته بومی لازم است، پیش از خرید این نیازها را جدا بنویسید. راهنمای انتخاب هاست برای Django و Flask برای مقایسه نوع پروژه مکمل است. گرانتر شدن سرویس بهخودیخود نام ورودی اشتباه، متغیر غایب و کد ناسازگار را اصلاح نمیکند.
- نسخه مفسر و رابط اجرای لازم را با مثال پروژه بنویسید.
- از پشتیبانی بپرسید مسیر ورود برنامه و لاگ شروع از کجا بررسی میشوند.
- امکان یک آزمون مستقل و روش اعمال تنظیمات محیطی را روشن کنید.
- نیاز به کتابخانه بومی، اتصال داده و کارگر جداگانه را پیش از انتقال اعلام کنید.
- رویه بازگشت، نسخه پشتیبان و مسئول رخداد را مشخص کنید.
- پیش از بردن داده واقعی، نتیجه تست سلامت و مسیر نمونه را ثبت کنید.
اگر میخواهید سازگاری پروژه را بررسی کنید، صفحه هاست پایتون وطن هاست را ببینید و با همان فهرست شرایط فعلی پلن را بسنجید. نام فریمورک، مفسر، رابط اجرا، بستههای ویژه و نیاز به فرایند جداگانه را هنگام مطرح کردن سؤال همراه بیاورید. اگر ربات تلگرام بخش اصلی پروژه است، هاست ربات تلگرام را هم از منظر نحوه اجرا و مشاهده لاگ مقایسه کنید. تصمیم را بر اساس نیاز قابل اثبات بگیرید، نه صرف عنوان سرویس.
پرسشهای متداول
آیا خطای 500 همیشه مشکل هاست است؟
خیر. استثنای برنامه، تنظیمات ناقص، بسته ناسازگار یا شرایط اجرای میزبان همگی میتوانند در مسیر تولید همین پاسخ نقش داشته باشند. از یک درخواست کنترلشده و زمان دقیق استفاده کنید و پیام را به لایهای که آن را ساخته ربط دهید.
چرا ترمینال برنامه را اجرا میکند ولی دامنه خطا میدهد؟
ممکن است مسیر کار، مفسر، کاربر اجرا یا متغیرهای محیطی در این دو متفاوت باشند. مسیر ورودی وب و محیط واقعی برنامه را کنترل کنید. موفق بودن نصب در یک ترمینال اثبات نمیکند وابستگی در مفسر وب قابل مشاهده ہے.
آیا برای رفع خطا باید DEBUG را روشن کرد؟
روی محیط عمومی خیر. این وضعیت ممکن است جزئیات حساس را نشان دهد. لاگ محدود و بازتولید در محیط آزمایش راه مطمئنتری برای خواندن جزئیاتاند.
اگر لاگ خالی است چه کنیم؟
زمان رخداد و منبع درست لاگ را تأیید کنید؛ لاگ شروع، لاگ درخواست و ثبت وبسرور ممکن است جدا باشند. اگر به منبع لازم دسترسی ندارید، از پشتیبانی با زمان و مسیر دقیق کمک بگیرید.
با تغییر WSGI به ASGI مشکل برطرف میشود؟
تنها وقتی باید روش اجرا را تغییر دهید که پروژه و محیط میزبان برای رابط جدید مناسب باشند. خطای نام ماژول، داده، پوشه یا محیط مجازی را از روی لاگ علتیابی کنید؛ رابط اجرا جای آن تحلیل را نمیگیرد.
جمعبندی
رفع خطای 500 در هاست پایتون از یک درخواست کمخطر و لاگ همان زمان شروع میشود. ابتدا بررسی کنید آیا برنامه بالا آمده است، سپس دامنه خطا را به مسیر، وابستگی یا داده محدود کنید. در فرایند اصلاح هر بار یک تغییر انجام دهید، نتیجه را با همان آزمون بخوانید و بهجای صفحه اول تنها، رفتار واقعی برنامه را هم امتحان کنید. برای خرید یا انتقال از پیش بپرسید چگونه میتوانید این شواهد را در اختیار داشته باشید. داشتن مسیر تشخیص روشن از افزودن منابع یا تغییر ابزار بدون شواهد برای پایداری پروژه ارزش بیشتری دارد.

دیدگاهها
در حال دریافت دیدگاهها…