رفع خطای «یک خطای مهم در این وب‌سایت رخ داده است» در وردپرس

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

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

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

با ما همراه باشید تا سایت‌تان را در سریع‌ترین زمان ممکن به حالت عادی برگردانید.

منظور از خطای مهم سایت چیست؟

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

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

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

اقدامات اولیه و بی‌خطر پیش‌از ویرایش کدها

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

صندوق ایمیل مدیر سایت را بررسی کنید (سریع‌ترین راه کشف خطا)

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

در این ایمیل دقیقاً قید شده که کدام افزونه یا کدام خط از کدهای قالب، باعث از کارافتادن سایت شده است.

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

حافظه کش مرورگر و سایت را پاک کنید

در برخی موارد، ممکن است منشأ اصلی خطا حل شده باشد یا فقط یک اختلال موقت در سرور رخ داده باشد، اما شما همچنان به‌دلیل ذخیره‌شدن اطلاعات قبلی در حافظۀ کش (Cache)، پیام خطا را ببینید.

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

همچنین اگر به پیشخوان وردپرس دسترسی دارید، حتماً یک‌بار کش افزونه‌هایی مثل LiteSpeed Cache را خالی کنید تا نسخۀ تازۀ سایت بارگذاری شود.

راه‌حل‌های فنی و گام‌به‌گام برای رفع ارور در وردپرس

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

قبل از اینکه دست به هرگونه ویرایش، تغییر نام یا دستکاری فایل‌های اصلی در روت (Root) وردپرس و دیتابیس بزنید، حتماً یک نسخۀ پشتیبان کامل از تمام فایل‌ها و پایگاه داده سایت بگیرید.

1. برای ردیابی دقیق، دیباگ (WP_DEBUG) را فعال کنید

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

حتماً بخوانید: 7 روش ارسال کد تایید | امن‌ترین مسیر‌های تحویل کد احراز هویت

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

۱. وارد کنترل‌پنل هاست (cPanel یا DirectAdmin) شوید و به مسیر public_html بروید.

۲. فایل wp-config.php را پیدا کرده و روی گزینۀ Edit کلیک کنید.

۳. خط ;define('WP_DEBUG', false) را پیدا کنید.

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

با تنظیم کد بالا، متن خطا روی صفحۀ عمومی سایت نمایش داده نمی‌شود تا امنیت مسیر فایل‌های هاست حفظ شود. در عوض، گزارش کامل و دقیق تمام خطاها در فایلی به نام debug.log داخل پوشۀ wp-content ذخیره می‌شود.

کافی است وارد پوشۀ wp-content شوید، این فایل متنی را باز کنید و آخرین خطوط آن را بخوانید تا اسم افزونه یا قالبی که باعث خطای استاپ (Fatal Error) شده را ببینید.

۵. فایل را ذخیره کرده و یک‌بار صفحۀ ارور سایت را رفرش کنید تا کدها اجرا شوند.

2. با غیرفعال‌سازی گروهی افزونه‌ها، تداخل آن‌ها را بررسی کنید

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

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

۱. در هاست به مسیر public_html/wp-content بروید.

۲. نام پوشۀ plugins را به plugins-old تغییر دهید. با این کار تمام افزونه‌های سایت به‌صورت یکجا غیرفعال می‌شوند.

۳. سایت را رفرش کنید. اگر سایت بدون ارور باز شد، یعنی قطعا مشکل از یکی از افزونه‌هاست.

4. وقتی اسم پوشۀ اصلی هنوز plugins-old است، وارد آن شوید. اسم تک‌تک پوشه‌های افزونه‌های داخل آن را تغییر دهید (مثلاً به انتهای اسم همۀ آن‌ها عدد ۱ اضافه کنید).

5. اسم پوشۀ اصلی را دوباره به plugins برگردانید (چون اسم پوشه‌های داخلی تغییر کرده، هیچ افزونه‌ای فعال نمی‌شود و سایت بدون ارور باز می‌شود).

6. حالا اسم پوشه‌ها را یکی‌یکی به حالت اصلی برگردانده و بعد از هر کدام، سایت را رفرش کنید. به‌محض اینکه بعد از پاک‌کردن عدد ۱ از اسم یک پوشه، سایت دوباره ارور داد، می‌فهمید که مشکل از همان افزونه است.

3. قالب‌های پیش‌فرض وردپرس را تست کنید

اگر با غیرفعال‌کردن افزونه‌ها مشکل حل نشد، احتمالاً قالب فعلی سایت دچار تداخل شده است:

۱. در هاست به مسیر public_html/wp-content/themes بروید.

۲. پوشۀ قالب فعال فعلی‌تان را پیدا کرده و نام آن را تغییر دهید (مثلاً یک عدد به انتهای نام آن اضافه کنید).

حتماً بخوانید: همه چیز دربارۀ درآمد طراحی سایت و برنامه نویسی

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

4. ظرفیت حافظه PHP سرور را افزایش دهید

اگر سنگینی کدهای قالب و افزونه‌ها از میزان رم (RAM) تخصیص‌یافته به وردپرس بیشتر باشد، سایت با خطای کمبود حافظه مواجه شده و پیام «یک خطای مهم» رخ می‌دهد.

برای افزایش این محدودیت در بخش عمومی و مدیریت سایت، مراحل زیر را طی کنید:

۱. وارد کنترل‌پنل هاست خود شوید و به مسیر public_html بروید.

۲. فایل wp-config.php را باز کرده و روی گزینۀ Edit کلیک کنید.

۳. درست قبل از خط /* That's all, stop editing! Happy publishing. */ کدهای زیر را قرار دهید:

کد اول سقف حافظۀ بخش عمومی سایت (فرانت‌اند) را روی ۲۵۶ مگابایت می‌گذارد.

اما کد دوم، لایۀ مکمل برای بخش پیشخوان (بک‌اند) است و میزان حافظۀ مدیریت را تا ۵۱۲ مگابایت افزایش می‌دهد تا موقع اجرای پردازش‌های سنگین در پنل، سایت قفل نکند.

5. نسخه PHP در دایرکت‌ادمین و سی‌پنل ارتقاء دهید

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

• در cPanel: وارد بخش MultiPHP Manager شوید، دامنۀ خود را انتخاب کرده و نسخۀ PHP را روی 8.1، 8.2 یا ۸.3 قرار دهید.
• در DirectAdmin: وارد بخش Domain Setup شوید، روی دامنه کلیک کرده و در بخش PHP Version Selector نسخۀ موردنظر را انتخاب کنید.

6. ازطریق فایل تاریخچه خطا (Error Log)، آن را ریشه‌یابی کنید

اگر همچنان دلیل خطا را پیدا نکرده‌اید، سرور شما تمام اتفاقات و خطاهای رخ‌داده را در یک فایل متنی ثبت می‌کند. کافی است وارد پوشۀ public_html در هاست شوید و فایلی به نام error_log را باز کنید.

آخرین خطوط این فایل، دقیقاً زمان و علت دقیق رخ‌دادن خطا را نشان می‌دهند.

از هوش مصنوعی برای تحلیل خطا استفاده کنید

اگر کدهای متنی نمایش‌داده‌شده در فایل debug.log یا صفحه سایت برای‌تان گنگ و نامفهوم است، متن خطا را کپی کرده و برای هوش مصنوعی (مثل ChatGPT، Gemini یا Claude) بفرستید.

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

7. رفع ارور صفحه سفید مرگ در محیط لوکال هاست

اگر سایت وردپرسی خود را روی لوکال هاست (مثل زمپ XAMPP یا ومپ WampServer) راه‌اندازی کرده‌اید و با این خطا مواجه شده‌اید، کار راحت‌تری در پیش دارید.

زیرا دسترسی مستقیم به تمامی فایل‌ها دارید و نگران قطع‌شدن دسترسی کاربران واقعی یا افت سئوی سایت نیستید.

حتماً بخوانید: آموزش جامع اتصال نرم‌افزار هلو به پنل پیامکی [+ارسال پیامک پترن از هلو]

۱. فعال‌سازی سریع دیباگ

وارد پوشۀ پروژه در سیستم خود (مثلاً مسیر C:\xampp\htdocs\your-site) شوید.

فایل wp-config.php را با یک ویرایشگر متن باز کرده و مقدار WP_DEBUG را روی true قرار دهید تا دلیل و مسیر دقیق خطا روی مرورگر نمایش داده شود.

۲. افزایش منابع PHP ازطریق فایل php.ini

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

1. نرم‌افزار XAMPP را باز کنید.

2. در کنار ماژول Apache روی دکمۀ Config کلیک کرده و گزینۀ php.ini را انتخاب کنید.

3. عبارت memory_limit را جستجو کرده و مقدار آن را به 256M یا 512M تغییر دهید.

4. عبارت max_execution_time را پیدا کرده و مقدار آن را روی 300 بگذارید.

5. فایل را ذخیره کرده و یک‌بار Apache را Stop و مجدداً Start کنید.

۳. تست سریع افزونه‌ها در ویندوز

بدون نیاز به هاست و اینترنت، مستقیماً به مسیر wp-content/plugins در پوشۀ سایت خود بروید. پوشۀ افزونه‌ای که اخیراً نصب یا آپدیت کرده‌اید را Rename کنید تا اثر آن فوراً از بین برود.

8. آخرین راه نجات؛ بازگردانی نسخه پشتیبان

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

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

۱. بازگردانی ازطریق هاست

اگر به پیشخوان وردپرس دسترسی ندارید، وارد پنل هاست خود شوید. بیشتر شرکت‌های هاستینگ، سرویس بکاپ‌گیری خودکار دارند (مثل ابزار JetBackup در سی‌پنل یا Backup Manager در دایرکت‌ادمین).

کافی است وارد این بخش شوید، تاریخی را که سایت کاملاً سالم بوده انتخاب کرده و روی گزینۀ Restore کلیک کنید تا فایل‌ها و دیتابیس به حالت قبل برگردند.

۲. بازگردانی ازطریق افزونه‌های بکاپ

اگر با استفاده از لینک ایمیل ریکاوری وردپرس توانستید وارد پیشخوان شوید و از قبل افزونه‌هایی مثل UpdraftPlus یا Duplicator روی سایت داشتید، کافی است به بخش افزونۀ مربوطه رفته و با انتخاب نسخۀ پشتیبان قبلی، دکمۀ Restore را بزنید.

پیش از بازگردانی بکاپ، توجه داشته باشید نوشته‌ها، دیدگاه‌ها یا سفارش‌های جدیدی که بین زمان تهیۀ بکاپ تا زمان بروز ارور ثبت شده‌اند بازنمی‌گردند. بنابراین، پیشنهاد می‌کنیم پس از بالاآمدن سایت، موارد اخیر را مجدداً بررسی کنید.

چطور پیش از کاربران متوجه خطای سایت شویم؟ دریافت هشدار پیامکی در لحظه بروز ارور

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

حتماً بخوانید: پنل پیام کوتاه ویژه برنامه‌نویسان و توسعه‌دهندگان

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

برای فعال‌سازی این سیستم پیشگیری، این مراحل را انجام دهید:

۱. استفاده از ابزارهای پایش آپ‌تایم: سرویس‌های رایگان و معتبری مثل UptimeRobot یا افزونه‌های مانیتورینگ وردپرس، هر چند دقیقه یک‌بار وضعیت کدهای سایت شما را بررسی می‌کنند.

۲. اتصال به وب‌سرویس پیامک: برای اتصال آن به پنل پیامکی، کافی است در بخش هشدارهای ابزار مانیتورینگ، آدرس وبسرویس پیامکی یا API Key خود را وارد کنید.

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

سخن پایانی؛ با چند اقدام ساده، سایت را به وضعیت عادی برگردانید

خطای «یک خطای مهم در این وب‌سایت رخ داده است»، با وجود ظاهر نگران‌کننده‌اش، یکی از رایج‌ترین مشکلات وردپرس به‌شمار می‌رود.

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

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