خطای صفحه سفید مرگ (WSoD) چیست و چگونه آن را برطرف کنیم؟

تصور کنید وقتی می‌خواهید وارد وب‌سایت وردپرسی‌تان شوید، فقط یک صفحه کاملا سفید ببینید، بدون هیچ خطایی یا حتی بدون اینکه هیچ سرنخی از اینکه چه اتفاقی افتاده است داشته باشید! این مشکل که با نام خطای صفحه سفید مرگ (WSoD) شناخته می‌شود، می‌تواند دلایل مختلفی از تداخل افزونه‌ها و قالب گرفته تا کمبود حافظه یا خطاهای PHP داشته باشد. اما جدای از نام ترسناک این مشکل، در بسیاری از موارد می‌توان با چند بررسی ساده، علت را مشخص و مشکل را رفع کرد. این مطلب از بخش آموزش مدیریت محتوا در بلاگ پارس‌پک به شما توضیح می‌دهد که صفحه سفید مرگ وردپرس چرا ایجاد می‌شود و چطور می‌توان آن را حل کرد.

خطای صفحه سفید مرگ چیست؟

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

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

علت خطای صفحه سفید وردپرس

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

• تداخل یا خرابی افزونه‌ها: یک افزونه ناسازگار یا دارای خطا می‌تواند اجرای سایت را متوقف کند.
• مشکل در قالب وردپرس: کدنویسی معیوب یا ناسازگاری قالب با نسخه وردپرس یا PHP ممکن است باعث WSoD شود.
• کمبود حافظه PHP: اگر سایت به حافظه بیشتری از مقدار تعیین‌شده نیاز داشته باشد، ممکن است صفحه سفید نمایش داده شود.
• خطاهای PHP: وجود خطای جدی در کدهای PHP می‌تواند مانع بارگذاری صحیح سایت شود.
• خرابی فایل‌های اصلی وردپرس: ناقص یا آسیب‌دیده بودن فایل‌های هسته وردپرس گاهی باعث این مشکل می‌شود.
• مشکلات سرور یا هاست: تنظیمات نادرست سرور، محدودیت منابع یا برخی اختلالات هاست نیز می‌توانند در بروز صفحه سفید نقش داشته باشند.

روش‌های رفع خطای صفحه سفید مرگ در وردپرس

برای رفع صفحه سفید مرگ وردپرس، بهتر است عیب‌یابی را از روش‌های ساده‌تر شروع کنید و در صورت حل نشدن مشکل، به سراغ تنظیمات فنی‌تر بروید. همچنین قبل از تغییر فایل‌های وردپرس، قالب یا تنظیمات PHP، بهتر است یک نسخه پشتیبان از سایت داشته باشید تا در صورت بروز مشکل، بتوانید شرایط را به حالت قبل برگردانید. در ادامه، نحوه حل مشکل صفحه سفید در وردپرس را توضیح داده‌ایم:

پاک‌سازی کش مرورگر و وردپرس

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

غیرفعال‌سازی افزونه‌های وردپرس

تداخل یا خرابی افزونه‌ها یکی از دلایل رایج WSoD (White Screen of Death) است. اگر به پیشخوان وردپرس دسترسی دارید، همه افزونه‌ها را موقتا غیرفعال کنید و سپس آن‌ها را یکی‌یکی فعال کنید تا افزونه مشکل‌ساز مشخص شود. اگر پیشخوان در دسترس نیست، از File Manager هاست یا FTP وارد مسیر wp-content/plugins شوید.

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

تغییر قالب فعال به قالب پیش‌فرض

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

اگر به پیشخوان دسترسی ندارید، از مسیر wp-content/themes وارد پوشه قالب‌ها شوید. سپس نام پوشه قالب فعال را تغییر دهید تا وردپرس نتواند آن را بارگذاری کند. اگر سایت بعد از این تغییر نمایش داده شد، باید قالب و کدهای آن را دقیق‌تر بررسی کنید.

فعال‌سازی حالت دیباگ وردپرس

از آنجا که خطای صفحه سفید مرگ معمولا اطلاعات واضحی درباره علت خطا نمایش نمی‌دهد، فعال‌سازی Debug وردپرس می‌تواند برای پیدا کردن خطای اصلی مفید باشد. برای این کار فایل wp-config.php را باز کرده و تنظیمات زیر را روی فایل اعمال کنید:

define( 'WP_DEBUG', true ); 
define( 'WP_DEBUG_LOG', true ); 
define( 'WP_DEBUG_DISPLAY', false );

نحوه انجام این کار در شکل زیر نشان داده شده‌است.

بعد از فعال‌سازی، خطاها معمولا در فایل wp-content/debug.log ثبت می‌شوند. بررسی این فایل می‌تواند نشان دهد کدام افزونه، قالب یا فایل PHP باعث ایجاد مشکل شده است. پس از رفع خطا بهتر است Debug دوباره غیرفعال شود.

افزایش محدودیت حافظه PHP

یکی دیگر از دلایلی که می‌تواند باعث خطای صفحه مرگ سفید شود، کمبود حافظه PHP است. اگر حین بررسی لاگ‌های هاست یا سرور با خطاهایی مانند Allowed memory size exhausted روبه‌رو شدید، بررسی و افزایش Memory Limit می‌تواند مشکل را برطرف کند.

این مقدار بسته به نوع هاست از طریق تنظیمات PHP، فایل php.ini، فایل .htaccess یا کنترل‌پنل هاست قابل تغییر است. اگر افزایش حافظه فقط به صورت موقت مشکل را حل کرد، بهتر است افزونه‌ها یا پردازش‌هایی که مصرف منابع بالایی دارند نیز بررسی شوند.

بررسی خطاهای PHP و کدنویسی

اگر صفحه سفید بعد از تغییر فایل‌هایی مانند functions.php، اضافه کردن کد سفارشی یا ویرایش قالب و افزونه ایجاد شده باشد، احتمال وجود خطای نحوی یا برنامه‌نویسی وجود دارد.

بررسی فایل debug.log و Error Log هاست می‌تواند نام فایل و خط ایجادکننده مشکل را مشخص کند. در این شرایط می‌توان کد معیوب را اصلاح کرد یا فایل را با نسخه سالم قبلی جایگزین کرد.

بازگردانی آخرین نسخه پشتیبان

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

البته Restore بک‌آپ بیشتر از اینکه علت اصلی مشکل را مشخص کند، یک راه بازیابی است، به عبارت دیگر بعد از بالا آمدن سایت همچنان بهتر است مشخص شود کدام تغییر باعث بروز خطا شده تا مشکل دوباره تکرار نشود.

بررسی به‌روزرسانی‌های ناموفق وردپرس

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

همچنین وردپرس هنگام به‌روزرسانی فایلی با نام maintenance. ایجاد می‌کند. اگر این فایل پس از پایان فرایند همچنان باقی مانده باشد، حذف آن پس از اطمینان از متوقف شدن Update می‌تواند مشکل را برطرف کند.

بررسی سطح دسترسی فایل‌ها و پوشه‌ها

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

در بسیاری از سرورها از سطح دسترسی ۷۵۵ برای پوشه‌ها و ۶۴۴ برای فایل‌ها استفاده می‌شود، هرچند مقدار دقیق می‌تواند به تنظیمات هاست بستگی داشته باشد. استفاده از سطح دسترسی ۷۷۷ نیز به دلیل ریسک امنیتی توصیه نمی‌شود. نحوه اعمال این تنظیمات در سی‌پنل، در شکل زیر نشان داده شده است.

بررسی نوشته‌ها و برگه‌های سنگین

اگر صفحه سفید فقط هنگام باز کردن یا ویرایش یک نوشته یا برگه خاص ایجاد می‌شود، ممکن است همان صفحه منابع بیشتری از حد معمول مصرف کند. محتوای بسیار طولانی، تعداد زیاد Revisionها، بلوک‌های پیچیده یا Page Builderهای سنگین می‌توانند فشار بیشتری به PHP وارد کنند. در چنین شرایطی می‌توان حجم صفحه، Revisionهای اضافی و بخش‌هایی که پردازش بیشتری نیاز دارند را بررسی کرد.

بررسی لاگ سرور یا هاست

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

ارتباط با پشتیبانی هاست

اگر با بررسی افزونه‌ها، قالب، Debug، حافظه و لاگ‌ها همچنان علت مشکل مشخص نشد، ممکن است خطا به تنظیمات سرور، نسخه PHP، محدودیت منابع یا مواردی مرتبط باشد که از داخل وردپرس قابل تغییر نیستند.

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

سفید شدن پیشخوان وردپرس

گاهی خطای صفحه سفید مرگ فقط در پیشخوان وردپرس دیده می‌شود، یعنی ممکن است سایت برای کاربران عادی همچنان باز شود، اما هنگام ورود به wp-admin صفحه‌ای سفید یا ناقص نمایش داده شود. این مشکل معمولا زمانی رخ می‌دهد که یکی از بخش‌های مرتبط با مدیریت وردپرس به درستی اجرا نشود. تداخل افزونه‌ها، خطا در کدهای سفارشی، کمبود حافظه PHP، ناسازگاری نسخه PHP با وردپرس یا ناقص ماندن یک به‌روزرسانی می‌تواند باعث بروز این وضعیت شود.

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

جمع‌بندی

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

سوالات متداول

خطای صفحه سفید مرگ وردپرس چیست؟

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

آیا افزونه‌ها می‌توانند باعث بروز مشکل صفحه سفید مرگ وردپرس شوند؟

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

اگر فقط پیشخوان وردپرس سفید شود، چه کاری باید انجام داد؟

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

آیا خطای صفحه سفید مرگ باعث حذف اطلاعات سایت می‌شود؟

خود خطای WSoD معمولا باعث حذف اطلاعات سایت نمی‌شود، اما ممکن است دسترسی به بخش‌هایی از سایت را مختل کند. با این حال، قبل از انجام تغییرات فنی یا بازیابی فایل‌ها بهتر است از سایت نسخه پشتیبان تهیه شود.