وقتی بعد از نصب یا بهروزرسانی یک افزونه صفحه سفید، خطای جاوااسکریپت یا رفتار عجیب دیده میشود، اولین حدس معمولاً «تداخل افزونهها» است. اما غیرفعال کردن چند افزونه روی سایت اصلی هم ریسک دارد و هم شواهد را از بین میبرد. عیبیابی حرفهای از ثبت دقیق نشانه شروع میشود و با یک آزمایش قابل تکرار به علت میرسد.
نشانه را دقیق ثبت کنید
نشانی صفحه، نقش کاربر، مرورگر، زمان وقوع و آخرین اقدام را یادداشت کنید. مشخص کنید خطا همیشه رخ میدهد یا فقط پس از ورود، روی موبایل یا در یک مرحله خرید دیده میشود. تصویر صفحه مفید است، اما متن خطا، کد وضعیت درخواست و مراحل بازتولید ارزش بیشتری دارند.
قبل از تغییر، شواهد جمع کنید
- گزارش خطای PHP و لاگ سرور را در همان بازه زمانی بررسی کنید.
- Console و Network مرورگر را برای خطای اسکریپت یا پاسخ ناموفق ببینید.
- نسخه وردپرس، PHP، قالب و افزونههای درگیر را ثبت کنید.
- کش صفحه، Object Cache و CDN را بهعنوان لایه جدا در نظر بگیرید.
هشدارهای قدیمی را با خطای تازه اشتباه نگیرید. ساعت سرور و زمان محلی را تطبیق دهید و تنها رخدادهای مرتبط با سناریوی آزمون را دنبال کنید.
آزمایش را به محیط جدا منتقل کنید
یک کپی Staging بسازید و ارسال ایمیل، پیامک و پرداخت واقعی را ببندید. سپس همان مراحل خطا را تکرار کنید. اگر خطا در نسخه آزمایشی رخ نداد، تفاوت محیطها مانند نسخه PHP، داده، کش یا تنظیمات سرور را بررسی کنید؛ نبود خطا لزوماً افزونه را بیتقصیر نمیکند.
بهجای آزمون تصادفی، محدوده را نصف کنید
در محیط آزمایشی نیمی از افزونههای غیرحیاتی را غیرفعال و سناریو را اجرا کنید. اگر خطا باقی بود، مسئله در نیمه فعال یا قالب است؛ اگر رفع شد، در نیمه غیرفعال دنبال کنید. این روش با تعداد آزمون کمتر به ترکیب مشکلساز میرسد. پس از پیدا کردن افزونه مظنون، آن را کنار قالب پیشفرض و سپس کنار افزونه مقابل آزمایش کنید.
عامل فعالکننده با علت ریشهای فرق دارد
ممکن است یک افزونه خطا را آشکار کند، اما علت اصلی داده ناقص، محدودیت حافظه، نسخه قدیمی کتابخانه یا کد سفارشی باشد. Stack trace، نام Hook و درخواست درگیر را بخوانید. اگر خطا فقط با ترتیب خاصی رخ میدهد، اولویت اجرای Hook یا بارگذاری تکراری کتابخانه را بررسی کنید.
راهحل موقت و دائمی را جدا کنید
بازگرداندن نسخه قبل یا غیرفعالسازی قابلیت میتواند سایت را سریع برگرداند، اما باید زمان پیگیری اصلاح دائمی، مسئول و معیار آزمون نسخه رفعشده ثبت شود. گزارش پشتیبانی شامل مراحل بازتولید، نسخهها، لاگ مرتبط و نتیجه مورد انتظار باشد؛ این اطلاعات از جمله «افزونه کار نمیکند» بسیار قابلاقدامتر است.
هدف عیبیابی پیدا کردن مقصر نیست؛ ساختن توضیحی است که بتوان با آن خطا را تکرار، اصلاح و از بازگشتش جلوگیری کرد.
