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

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

۱. قبل از هر کاری: تهیه بک‌آپ کامل

 اولین قانون طلایی این است:
هر تغییری = یک بک‌آپ کامل از فایل‌ها + دیتابیس

برای این کار می‌توانید از روش‌های زیر استفاده کنید:

• دانلود پوشه public_html از File Manager

• Export دیتابیس از phpMyAdmin

• یا استفاده از افزونه‌هایی مثل UpdraftPlus (اگر سایت هنوز بالا می‌آید)

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

۲. فعال کردن حالت دیباگ (دیدن خطای واقعی پشت پرده)

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

برای این کار:

۱. وارد File Manager شوید
۲. فایل wp-config.php را باز کنید
۳. این سه خط را اضافه یا ویرایش کنید:

حالا خطاها در فایل wp-content/debug.log ذخیره می‌شوند.

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

۳. بررسی کامل debug.log و خطاهای سرور

بعد از فعال‌کردن دیباگ، وارد مسیر زیر شوید:

/wp-content/debug.log

اگر فایل ساخته نشده، به پوشه error_log اصلی هاست سر بزنید.

مواردی که باید دنبالشان باشید:

• Fatal error

• Memory exhausted

• Call to undefined function

• Allowed memory size exhausted

• Syntax error در فایل‌های افزونه یا قالب

این خطاها دقیقاً می‌گویند مشکل از کجاست.

مثال واقعی:
اگر خطا چنین باشد:

یعنی مشکل از نسخه خراب یا ناقص Elementor است.
در ۸۰٪ موارد، همین لاگ مشکل را مشخص می‌کند.

۴. غیرفعال کردن سریع افزونه‌ها (تست تداخل افزونه‌ها)

بیشترین علت این خطا تداخل افزونه‌ها است.
اگر به پیشخوان دسترسی ندارید:

۱. وارد مسیر wp-content شوید
۲. نام پوشه plugins را به plugins-off تغییر دهید
۳. سایت را رفرش کنید

اگر سایت بالا آمد => یکی از افزونه‌ها مقصر است.

حالا:
پوشه را دوباره به plugins برگردانید
سپس افزونه‌ها را یکی‌یکی غیرفعال کنید تا افزونه مشکل‌ساز پیدا شود.

نکته:
افزونه‌های سنگین مثل:

• Elementor

• WPML

• WooCommerce extensions

• امنیتی‌ها

• کش‌ها (LiteSpeed / WP Rocket)

بیشتر از بقیه خطا ایجاد می‌کنند.

۵. بررسی قالب فعال (Theme)

اگر مشکل از افزونه نبود، نوبت قالب است.

۱. وارد مسیر wp-content/themes شوید
۲. پوشه قالب فعال را به نام دیگری تغییر دهید
۳. وردپرس به‌طور خودکار یکی از قالب‌های پیش‌فرض مثل Twenty Twenty-Three را فعال می‌کند

اگر سایت بالا آمد:
قالب فعلی با وردپرس یا PHP سازگار نیست.

راه‌حل:

• قالب را از منبع اصلی دوباره دانلود کنید

• نسخه جدید را نصب کنید

• یا با پشتیبانی قالب ارتباط بگیرید

۶. مشکل نسخه PHP و محدودیت حافظه (Memory Limit)

گاهی خطا به دلیل کمبود منابع است؛ مخصوصاً روی هاست‌های اشتراکی.

 باید موارد زیر را چک کنید:

✔ نسخه PHP مناسب

وردپرس معمولاً با نسخه‌های ۸.۰ تا ۸.۲ بهترین عملکرد را دارد.
افزونه‌های قدیمی با PHP 8.2 مشکل دارند.

اگر after update این خطا ظاهر شد، ابتدا PHP را یک نسخه پایین بیاورید.

✔ افزایش Memory Limit

به فایل wp-config.php اضافه کنید:

یا از هاست بخواهید Limit را تا ۵۱۲M افزایش دهد.

۷. نصب مجدد فایل‌های هسته وردپرس (بدون حذف محتوا)

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

برای رفع آن:

۱. آخرین نسخه وردپرس را از سایت رسمی دانلود کنید
۲. فقط پوشه‌های
wp-admin و wp-includes
را حذف و نسخه جدید را آپلود کنید
۳. پوشه wp-content را دست نزنید

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

۸. بررسی کرون‌جاب‌ها و تاسک‌های معلق

اگر فروشگاه ووکامرسی دارید، ممکن است سفارش‌های سنگین یا برنامه‌های زمان‌بندی (CRON) سایت را دچار اختلال کنند.

چک کنید:

• wp_cron فعال باشد

• صف پردازش WooCommerce گیر نکرده باشد

• افزونه‌های اتوماسیون مثل SMTP، بک‌آپ، امنیت، ریدایرکت‌ها مشکل ایجاد نکرده باشند

۹. خطا بعد از نصب افزونه جدید

اگر بلافاصله بعد از نصب افزونه این خطا را دیدید:

• افزونه با نسخه وردپرس سازگار نیست

• فایل نصب ناقص بوده

• یا با افزونه‌ای دیگر تداخل دارد

در چنین شرایطی بهترین راه:

• حذف افزونه از FTP

• پاکسازی پوشه‌های باقی‌مانده

• و نصب نسخه معتبر از سایت اصلی

۱۰. خطا هنگام ورود به wp-admin

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

راه‌حل‌ها:

• تغییر نام پوشه افزونه امنیتی

• حذف پوشه Cache

• ریست رمز از طریق دیتابیس

• ریست نقش‌ها از طریق افزونه User Role Editor (پس از حل مشکل)

۱۱. استفاده از ابزار Health Check

افزونه رسمی Health Check & Troubleshooting برای تشخیص تداخل‌ها بدون ایجاد مشکل در سایت اصلی فوق‌العاده است.

این افزونه:

• سایت را در “Safe Mode” اجرا می‌کند

• افزونه‌ها را تکی تست می‌کند

• نسخه PHP و MySQL را چک می‌کند

• مشکلات سرور را گزارش می‌دهد

 این ابزار باید همیشه در جعبه‌ابزار شما باشد.

۱۲. زمانی که هیچ روشی جواب نداد

اگر بعد از انجام همه مراحل هنوز مشکل باقی بود:

✔ احتمال خرابی دیتابیس وجود دارد
✔ ممکن است جدول‌های زیر آسیب دیده باشند:

• wp_options

• wp_posts

• wp_usermeta

• wp_termmeta

می‌توانید از phpMyAdmin گزینه Repair Database را اجرا کنید.

اگر باز هم مشکل حل نشد، بهترین انتخاب این است که:

• از بک‌آپ سالم سایت استفاده کنید

• یا مشکل را به پشتیبان هاست ارجاع دهید (در موارد مربوط به PHP یا ماژول‌های سرور)

جمع‌بندی: بهترین مسیر رفع خطای مهم وردپرس 

برای رفع سریع این خطا، این ترتیب بهترین است:

۱. فعال‌سازی دیباگ و بررسی debug.log
۲. غیرفعال‌کردن افزونه‌ها
۳. تست قالب
۴. بررسی نسخه PHP و حافظه
۵. نصب مجدد فایل‌های وردپرس
۶. حل مشکلات CRON و دیتابیس
۷. بررسی ابزارهای امنیتی و کش

در ۹۵٪ مواقع مشکل از تداخل افزونه یا کمبود منابع سرور است.