فهرست مطالب
صفحه سفید وردپرس (White Screen of Death) یعنی وردپرس به یک خطای مهلک PHP خورده ولی نمایش خطا خاموش است، پس به جای پیام فقط صفحه‌ای خالی میبینید. علت تقریباً همیشه همان علت‌های خطای مهم وردپرس است: افزونه یا قالب ناسازگار، کد اشتباه یا کمبود حافظه PHP. راه رفع: نسخه پشتیبان بگیرید، لاگ خطا را با WP_DEBUG_LOG فعال کنید تا علت معلوم شود، و فقط عامل مقصر را غیرفعال کنید.
نویسنده: تیم siloow (سیلو سولوشن) — آخرین به‌روزرسانی: آبان ۱۴۰۵
چرا صفحه سفید میشود؟
- خطای افزونه یا قالب بعد از نصب یا به‌روزرسانی؛ در نسخههای جدید وردپرس معمولاً پیام «خطای مهمی رخ داده» نمایش داده میشود، ولی بسته به تنظیمات هاست یا خطاهایی که پیش از بارگذاری کامل وردپرس رخ می‌دهند، ممکن است فقط صفحه سفید ببینید.
- کمبود حافظه PHP برای صفحه‌سازها یا افزونه‌های سنگین.
- خطای نگارشی در کد، مثلاً در
functions.phpیاwp-config.php. - مشکل کش: افزونه کش یا CDN یک نسخه خالی از صفحه را ذخیره کرده و به همه نشان می‌دهد.
چه کار کنیم؟
- اول کش را کنار بگذارید: صفحه را در پنجره ناشناس با افزودن یک پارامتر ساده به آدرس باز کنید یا کش افزونه و CDN را پاک کنید. اگر سایت درست شد، مشکل فقط از کش بوده است.
- پیشخوان را امتحان کنید: اگر
/wp-adminباز میشود، معمولاً مشکل از قالب یا افزونه‌ای است که فقط در بخش عمومی اجرا میشود. - ایمیل مدیر را ببینید: ممکن است وردپرس لینک «حالت بازیابی» فرستاده باشد.
- نسخه پشتیبان بگیرید و بعد در
wp-config.phpاین خطوط را بگذارید:define( 'WP_DEBUG', true );،define( 'WP_DEBUG_LOG', true );وdefine( 'WP_DEBUG_DISPLAY', false );. صفحه را دوباره باز کنید و فایلwp-content/debug.logرا بخوانید. - مقصر را غیرفعال کنید: اگر مسیر خطا به پوشه یک افزونه اشاره دارد، نام همان پوشه را با FTP یا File Manager تغییر دهید. اگر به قالب اشاره دارد، نام پوشه قالب فعال را تغییر دهید تا وردپرس به قالب پیش‌فرض نصب‌شده برگردد.
- اگر لاگ از حافظه حرف می‌زند، سقف حافظه PHP را بالا ببرید (در پاسخ مخصوص خطای memory exhausted توضیح داده‌ایم).
- دیباگ را خاموش کنید و
debug.logرا بعد از رفع مشکل حذف کنید.
| نشانه | علت محتمل | اقدام |
|---|---|---|
| فقط برای بازدیدکننده‌ها سفید است | کش یا CDN | پاک‌کردن کش |
| سایت سفید، پیشخوان سالم | قالب یا افزونه بخش عمومی | غیرفعال‌کردن از پیشخوان |
| همه‌جا سفید | خطای مهلک افزونه، قالب یا کد | لاگ خطا و تغییر نام پوشه |
| فقط صفحه‌های سنگین سفیدند | کمبود حافظه | افزایش حافظه PHP |
نکته: هرگز
WP_DEBUG_DISPLAYرا روی سایت زنده روشن نگذارید؛ نمایش خطا روی صفحه ممکن است مسیر فایل‌ها و اطلاعات فنی سایت را به همه نشان دهد. ثبت در لاگ کافی و امن‌تر است.
اگر به جای صفحه سفید پیام خطا میبینید، پاسخ «در این وب‌سایت خطای مهمی رخ داده است» یعنی چی و خطای ۵۰۰ وردپرس را ببینید. توضیح رسمی ثابت‌های دیباگ در راهنمای دیباگ وردپرس آمده است.
کی بهتر است از متخصص کمک بگیرید؟
اگر لاگ خطا خالی است، خطا از قالب اختصاصی یا کد سفارشی است، یا ویرایش wp-config.php برایتان آشنا نیست، بهتر است کار را به متخصص بسپارید. یک کاراکتر اشتباه در این فایل خودش می‌تواند صفحه سفید جدیدی بسازد.
اگر سایت شما صفحه سفید نشان می‌دهد، فرم تماس siloow را پر کنید؛ تیم ما در اولین فرصت سایت را بررسی و با شما تماس می‌گیرد.
سوالات متداول
صفحه سفید وردپرس با خطای مهم وردپرس چه فرقی دارد؟
هر دو معمولاً از یک خطای مهلک PHP میآیند. در نسخههای جدید وردپرس پیام «خطای مهمی رخ داده است» نمایش داده میشود، ولی در بعضی تنظیمات یا خطاها فقط صفحه خالی میبینید؛ روش رفع تقریباً یکی است.
چرا debug.log ساخته نمی‌شود؟
ممکن است خطوط دیباگ بعد از خط پایانی wp-config.php قرار گرفته باشند یا پوشه wp-content مجوز نوشتن نداشته باشد. خطوط را قبل از «That’s all, stop editing» بگذارید و لاگ خطای هاست را هم ببینید.
آیا نصب دوباره وردپرس صفحه سفید را درست میکند؟
معمولاً لازم نیست و اگر بیاحتیاط انجام شود خطرناک است. علت اغلب در افزونه یا قالب است، نه در هسته وردپرس؛ اول لاگ خطا را بخوانید.
مشکل
سایت وردپرسی صفحه سفید و خالی نشان می‌دهد
علائم و نشانه‌ها
- صفحه کاملاً سفید، بدون پیام خطا، گاهی فقط در بخش عمومی
علت‌های احتمالی
- خطای مهلک افزونه یا قالب، کد اشتباه، کمبود حافظه، کش خراب
راه‌حل کوتاه
کش را پاک کنید، پشتیبان بگیرید، WP_DEBUG_LOG را فعال و مقصر را با تغییر نام پوشه غیرفعال کنید.
ابزارهای موردنیاز
- wp-config.php، debug.log، FTP یا File Manager
