راهنمای عیب یابی رایج وردپرس
مقدمه #
وردپرس یک سیستم مدیریت محتوای (CMS) محبوب است که به شما امکان می دهد وب سایت ها، نمونه کارها و برنامه های تجارت الکترونیک بسازید. اگرچه این یک پلتفرم کاربرپسند است، اما خطاهای رایجی در وردپرس وجود دارد که بسته به میزان خطاهای نمایش داده شده به بازدیدکننده سایت یا داشبورد مدیر، عیب یابی آن را دشوار می کند.
بسته به منبع خطا، اکثر خطاهای وردپرس نتیجه زیرساخت های زیربنایی هستند که وظیفه ارائه برنامه شما به بازدیدکنندگان سایت را بر عهده دارند. در این حالت، اگر پیکربندی وب سرور شما دچار مشکل شود، سایت وردپرس شما به طور خودکار خطایی را به بازدیدکنندگان سایت نشان می دهد، که باید با عیب یابی عملکردهای وب سرور، آن را برطرف کنید.
خطاهای وردپرس در سمت کاربر، هشدارهای کوچکی هستند که معمولاً ساختار سایت شما را خراب نمی کنند، اما هر بار که سایت شما برای بازدیدکننده جدید بارگذاری می شود، تأثیر زیادی بر تجربه کاربری می گذارند. در این حالت، باید خطاهای رایج افزونه، هسته وردپرس و قالب را بررسی کنید تا از هرگونه خطای اضافی جلوگیری شود.
این مقاله خطاهای رایج وردپرس در بک اند و فرانت اند و نحوه عیب یابی آنها برای بهبود قابلیت اطمینان سایت شما را توضیح می دهد.
پیش نیازها #
قبل از شروع، مطمئن شوید که:
- یک سایت وردپرس فعال داشته باشید. اگر ندارید هاست وردپرس از ما تهیه کنید!
- به عنوان کاربر ادمین وارد سایت وردپرس خود شوید
https://example.com/wp-admin - دسترسی SSH یا ترمینال به سرور وردپرس داشته باشید
خطاهای رایج وردپرس #
بسیاری از خطاهای وردپرس هر بار که یک به روزرسانی بزرگ جدید منتشر می شود، کشف می شوند. بسته به خطای دقیق شما، در زیر ۱۰ مورد از رایج ترین خطاهای وردپرس که بر عملکرد سایت، رتبه بندی جستجو، قابلیت اطمینان و گاهی اوقات منجر به از دست رفتن کامل داده ها می شوند، آورده شده است.
- خطا در ایجاد اتصال به پایگاه داده
- اتصال شما خصوصی نیست (گواهی SSL نامعتبر است)
- صفحه سفید مرگ وردپرس (صفحه خالی)
- خطای داخلی سرور (۵۰۰)
- یادداشت صفحه ۴۰۴ پیدا شد
- خطای آپلود: نوشتن فایل روی دیسک ناموفق بود
- خطای ۵۰۳ عدم دسترسی به سرویس
- سایت با مشکلات فنی مواجه است
- خطای ۴۰۳ ممنوعه
- خطای محتوای ترکیبی
عیب یابی خطاهای رایج وردپرس #
برای عیب یابی و رفع خطاهای رایج وردپرس، قبل از اینکه برای یافتن راه حل اقدام کنید، باید منبع دقیق خطا را بدانید. معمولاً برای رفع خطاهای وردپرس باید مراحل عیب یابی اولیه شرح داده شده در این بخش را دنبال کنید.
مشاهده لاگ های وردپرس
گزارش گیری وردپرس به شما این امکان را می دهد که خطاها را در یک فایل خروجی مشاهده کنید. به طور پیش فرض، این ویژگی غیرفعال است، آن را فعال کنید تا هرگونه خطای اشکال زدایی وردپرس که ممکن است نمایش داده شود و بر عملکرد سایت شما تأثیر بگذارد، همانطور که در زیر توضیح داده شده است، پیگیری شود.
- به دایرکتوری ریشه وب وردپرس خود بروید. برای مثال
/var/www/html،/var/www/public_html،/var/www/example.com/$ cd /var/www/html - با استفاده از یک ویرایشگر متن دلخواه مانند
nano،wp-config.phpفایل را ویرایش کنید$ nano wp-config.php - برای فعال کردن ثبت وقایع وردپرس، دستور زیر را در انتهای فایل اضافه کنید.
define('WP_DEBUG_LOG', true);فایل را ذخیره و ببندید
wp-contentبه دایرکتوری بروید$ cd /wp-content/- فهرست کردن فایل ها و تأیید
debug.logوجود فایل جدید در دایرکتوری$ ls debug.logبرای دسترسی به گزارش های خطای وردپرس، فایل را مشاهده کنید.$ cat debug.logهر بار که سایت وردپرس شما با خطایی مواجه می شود، این خطا در
debug.logفایل ثبت می شود. همیشه فایل را مشاهده کنید تا منبع دقیق خطا را شناسایی کنید. برای مثال:[2023-07-07 12:00:01] PHP Fatal error: Call to undefined function get_non_existent_function() in /var/www/example.com/wp-content/plugins/custom-plugin/plugin-file.php on line 644خطای بالا نشان می دهد که شما
custom-pluginخطایی در خط ۶۴۴ برمی گردانید. می توانید فایل افزونه را ویرایش کنید تا آن را اصلاح کنید، یا افزونه را غیرفعال کنید تا از هرگونه خطای اضافی جلوگیری شود.
فعال کردن اشکال زدایی وردپرس
اشکال زدایی وردپرس امکان نمایش خطاها در سایت وردپرس شما را برای عیب یابی توسط مدیر فراهم می کند. معمولاً این خطاها زمانی ظاهر می شوند که هر یک از قالب ها یا افزونه های نصب شده به طور ضعیف کدگذاری شده باشند یا خطاهای زمان اجرا را برگردانند. به طور پیش فرض، اشکال زدایی وردپرس فعال نیست، آن را طبق مراحل زیر فعال کنید.
wp-config.phpفایل را ویرایش کنید$ nano wp-config.php- دستورات زیر را در انتهای فایل اضافه کنید
define('WP_DEBUG_DISPLAY', false); define('WP_DEBUG_LOG', true);فایل را ذخیره و ببندید
دستورالعمل های بالا، اشکال زدایی وردپرس را فعال کرده و نمایش خطاها را در صفحه بازدیدکننده سایت شما غیرفعال می کنند. این به شما امکان می دهد منبع دقیق خطای وردپرس را بدانید و جزئیات کافی برای اصلاح آن و جلوگیری از هرگونه خطای اضافی در برنامه خود را در اختیار داشته باشید.
مشاهده گزارش های وب سرور
وب سرور، جزء ریشه سایت وردپرس شماست که آن را در حال اجرا نگه می دارد. اکثر پیاده سازی های وردپرس یا از ، ، یا به عنوان برنامه وب سرور استفاده می کنند Apache. Nginxبسته OpenLiteSpeedبه Caddyپیاده سازی شما، گزارش های وب سرور را بررسی کنید تا منبع خطای وردپرس را همانطور که در مراحل زیر توضیح داده شده است، شناسایی کنید.
/var/log/به دایرکت مراجعه کنید$ cd /var/log- به دایرکتوری لاگ های وب سرور بروید. برای مثال
Nginx$ cd /var/log/nginx - مشاهده گزارش خطا
$ sudo cat error.logاگر پیکربندی وردپرس شما از یک گزارش خطای سفارشی Nginx مانند example.com.error.log استفاده می کند، محتوای فایل را برای نمایش خطای خاص برنامه مشاهده کنید.
$ sudo cat example.com.error.logاگر سایت وردپرس شما خطایی مربوط به وب سرور دارد، باید در ورودی های فایل لاگ شما نمایش داده شود.
2023/08/07 12:00:00 [error] 12345#0: *6789 open() "/var/www/example.com/productabc.html" failed (2: No such file or directory), client: 192.0.2.100, server: example.com, request: "GET /missing-page.html HTTP/1.1", host: "example.com"خطای بالا نشان می دهد که وب سرور خطای ۴۰۴ را نمایش می دهد زیرا
productabc.htmlفایل در دایرکتوری ریشه وب وردپرس قابل خواندن یا در دسترس نیست.
فعال کردن حالت بازیابی وردپرس
حالت بازیابی وردپرس به شما این امکان را می دهد که با دسترسی موقت به داشبورد مدیریت تا زمان حل شدن همه مشکلات، خطاها را عیب یابی کنید. معمولاً وقتی یک خطای بحرانی رخ می دهد، مدیر سایت یک لینک بازیابی دریافت می کند که از طریق آن می توانید به داشبورد وردپرس دسترسی پیدا کنید. در صورتی که هیچ ایمیل وردپرسی دریافت نکردید، حالت بازیابی را طبق مراحل زیر فعال کنید.
- از لینک بازیابی وردپرس استفاده کنید
https://example.com/wp-login.php?action=entered_recovery_modeوقتی از شما خواسته شد، نام کاربری و رمز عبور مدیر وردپرس خود را وارد کنید تا به حالت بازیابی دسترسی پیدا کنید.

راهنمای عیب یابی وردپرس - در حالت ریکاوری، از منوی اصلی به بخش ابزارها (Tools) بروید.
- از لیست کشویی روی سلامت سایت کلیک کنید
- مشکلات فعلی وردپرس را در صفحه وضعیت مشاهده کنید
- برای جلوگیری از هرگونه خطای اضافی، هر یک از مشکلات وردپرس را برطرف کنید و تأیید کنید که وضعیت شما به خوب تغییر می کند.

نحوه رفع خطای ایجاد اتصال به پایگاه داده در وردپرس
خطای برقراری اتصال به پایگاه داده رایج است و زمانی نمایش داده می شود که وردپرس قادر به نوشتن در پایگاه داده با استفاده از نام کاربری و رمز عبور موجود در wp-config.phpفایل شما نیست. معمولاً سرور پایگاه داده می تواند با خطا مواجه شود یا کاربر شما نمی تواند در پایگاه داده وردپرس بنویسد. این خطا را طبق مراحل زیر برطرف کنید.
- تأیید کنید که سرور پایگاه داده فعال و در حال اجرا است
$ sudo systemctl status mysqlخروجی:
● mariadb.service - MariaDB 10.11.4 database server Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; vendor preset: enabled) Drop-In: /etc/systemd/system/mariadb.service.d └─migrated-from-my.cnf-settings.conf Active: active (running) since Sat 2023-07-15 20:19:00 UTC; 1 month 15 days ago Docs: man:mariadbd(8) https://mariadb.com/kb/en/library/systemd/ Main PID: 25878 (mariadbd) Status: "Taking your SQL requests now..."اگر وضعیت سرور پایگاه داده غیرفعال (ناموفق) است ، آن را مجدداً راه اندازی کنید تا به همه پایگاه های داده دسترسی پیدا کنید.
$ sudo systemctl restart mysqlتأیید کنید که با وجود هرگونه خطا، به درستی اجرا می شود. در غیر این صورت، گزارش های پایگاه داده را مشاهده کنید تا منبع خطا را مشخص کنید.
$ sudo cat /var/log/mysql/error.logخروجی:
2023-08-07T12:00:00.123456Z 0 [Note] InnoDB: Buffer pool(s) load completed at 210707 12:00:00 2023-08-07T12:00:01.234567Z 0 [ERROR] mysqld: Out of memory (Needed 123456 bytes) 2023-08-07T12:00:03.456789Z 0 [ERROR] Table 'mydatabase.mytable' doesn't exist 2023-08-07T12:00:04.567890Z 0 [ERROR] Can't start server: Bind on TCP/IP port: Address already inهمانطور که در خروجی بالا نشان داده شده است، سرور پایگاه داده MySQL به دلیل کمبود حافظه سرور قادر به شروع به کار نیست و با برنامه دیگری در پورت تداخل دارد
3306. - محتویات
wp-config.phpفایل خود را بررسی کنید$ cat /var/www/example.com/wp-config.phpخروجی:
/** The name of the database for WordPress */ define( 'DB_NAME', 'wordpressdb' ); /** MySQL database username */ define( 'DB_USER', 'wpuser' ); /** MySQL database password */ define( 'DB_PASSWORD', 'strong-password' ); /** MySQL hostname */ define( 'DB_HOST', 'localhost' ); /** Database Charset to use in creating database tables. */ define( 'DB_CHARSET', 'utf8' ); /** WordPress Database Table prefix. */ $table_prefix = 'wp_';تأیید کنید که نام پایگاه داده، نام کاربری و رمز عبور با رکوردهای واقعی در سرور پایگاه داده MySQL شما مطابقت داشته باشد. همچنین، به
$table_prefix =دستورالعملی که باید با سبک نامگذاری پایگاه داده شما مطابقت داشته باشد، توجه کنید. برای آزمایش دسترسی کاربر، به سرور پایگاه داده MySQL وارد شوید.$ mysql -u wpuser -pوقتی از شما خواسته شد، رمز عبور خود را وارد کنید
پایگاه های داده موجود را مشاهده کنید و تأیید کنید که پایگاه داده وردپرس در لیست نمایش داده می شود.
> SHOW DATABASES;به پایگاه داده تغییر دهید
> USE wordpressdb;جداول پایگاه داده را مشاهده کنید و تأیید کنید که پیشوند نامگذاری با
$table_prefix =مقدار شما درwp-config.phpفایل مطابقت دارد.> SHOW TABLES;خروجی:
+----------------------------+ | Tables_in_wordpressdb | +----------------------------+ | wp_actionscheduler_actions | | wp_actionscheduler_claims | | wp_actionscheduler_groups | | wp_actionscheduler_logs | | wp_as3cf_items | | wp_commentmeta | | wp_comments | | wp_e_events | | wp_links |همانطور که در خروجی نمایش داده می شود،
wpپیشوند جداول وردپرس باید درwp-config.phpفایل شما نمایش داده شود.
نحوه رفع خطای اتصال شما خصوصی نیست (گواهی SSL نامعتبر است)
وقتی سرور وردپرس شما با یک گواهی SSL نامعتبر اجرا می شود، قبل از بارگذاری سایت، یک خطای مرورگر Insecure Connectionوب Your Connection is not Privateبرای هر بازدیدکننده سایت نمایش داده می شود. برای رفع این خطا، تأیید کنید که سرور وب شما به گواهی های SSL صحیح اشاره می کند. هنگام استفاده از گواهی Let’s Encrypt رایگان، از ابزار Certbot برای تمدید یا تولید مجدد گواهی های SSL برای دامنه خود، همانطور که در زیر توضیح داده شده است، استفاده کنید.
- به دایرکتوری فایل های میزبان مجازی وب سرور بروید. برای مثال
/etc/nginx/sites-enabled$ cd /etc/nginx/sites-enabled/ - فایل پیکربندی میزبان وردپرس خود را مشاهده کنید
$ cat example.comهنگام اجرای چندین سایت وردپرس روی یک وب سرور، از دستور زیر برای شناسایی فایل پیکربندی هدف خود استفاده کنید.
example.comنام دامنه واقعی خود را جایگزین کنید.$ grep -r "example.com" /etc/nginx/sites-enabled/ - تأیید کنید که دستورالعمل های
ssl_certificateandssl_certificate_keyبه/etc/letsencrypt/live/دایرکتوری اشاره می کنند.# SSL certificate managed by Certbot ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; - با استفاده از
certbotابزار کلاینت، یک گواهی SSL جدید برای سایت وردپرس خود ایجاد کنید. آن راexample.comبا نام دامنه واقعی خود جایگزین کنید.$ sudo certbot --nginx -d example.comتأیید کنید که فرآیند صدور گواهی موفقیت آمیز بوده است
- آزمایش کنید که گواهی پس از انقضا به طور خودکار تمدید شود
$ sudo certbot renew --dry-runخروجی:
Saving debug log to /var/log/letsencrypt/letsencrypt.log - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Processing /etc/letsencrypt/renewal/example.com.conf - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Account registered.در صورت موفقیت، Certbot به طور خودکار گواهی SSL وردپرس شما را هر ۹۰ روز تمدید می کند.
- در مرورگر وب خود، از سایت وردپرس خود بازدید کنید تا دسترسی HTTPS را آزمایش کنید و مطمئن شوید که
Invalid SSL certificateخطا دیگر برای بازدیدکنندگان سایت نمایش داده نمی شود.https://example.com
برای پیاده سازی انواع مختلف گواهینامه SSL، به منابع زیر مراجعه کنید:
- گواهی نامه اس اس ال
- استفاده از کلودفلر و فایروال ولتر برای محافظت از سرور ابری ولتر
- نصب Let’s Encrypt SSL روی اوبونتو با آپاچی یا انجین ایکس
نحوه رفع خطای ۵۰۳ Service Unavailable
خطای ۵۰۳ سرویس در دسترس نیست وردپرس معمولاً نتیجه محدودیت منابع در سرور شماست. معمولاً وقتی سرور وردپرس شما به حداکثر حجم پهنای باند مجاز شما می رسد، این خطا به صورت عدم موفقیت درخواست های داده نمایش داده می شود. همچنین، می تواند ناشی از افزونه ها یا فایل های قالب با کدنویسی ضعیف باشد، خطا را طبق مراحل زیر برطرف کنید.
- به کنترل پنل سرور وردپرس خود وارد شوید و تأیید کنید که سرور شما پهنای باند کافی اختصاص داده است.
بسته به ارائه دهنده هاستینگ شما، پهنای باند نامحدود ممکن است در کنترل پنل شما نمایش داده شود، اما وقتی به طور غیرمستقیم محدود باشد. اگر محدودیت پهنای باند را شناسایی کردید، به یک ارائه دهنده قیمت گذاری قابل پیش بینی مانند نگار نوین مهاجرت کنید تا سرور خود را با نیازهای خود مقیاس بندی کنید.
- گزارش های خطای وب سرور خود را مشاهده کنید و منبع خطا را تأیید کنید
$ sudo cat /var/log/nginx/error.log - تأیید کنید که PHP-FPM به درستی روی سرور شما اجرا می شود تا اسکریپت های PHP را مدیریت کند.
$ sudo systemctl status php-fpmبسته به نسخه PHP خود، می توانید برای مشاهده وضعیت FPM نام را تغییر دهید. برای مثال
php8.1-fpm - اگر خطا همچنان ادامه داشت، به
wp-contentدایرکتوری خود بروید$ cd /wp-content - تغییر نام دایرکتوری به
plugins_old$ mv plugins plugins_oldدایرکتوری را دوباره ایجاد کنید
pluginsو بررسی کنید که آیا خطا برطرف شده است یا خیر. در غیر این صورت، وضعیت زیرساخت سرور، وب سرور و گزارش های خطای وردپرس را بررسی کنید تا منبع دقیق خطا را پیدا کنید.
چگونه خطای ۴۰۴ صفحه پیدا نشد را برطرف کنیم
خطای HTTP ۴۰۴ زمانی نمایش داده می شود که وب سرور قادر به یافتن منبع درخواستی روی سرور نباشد. برای مثال، وقتی بازدیدکننده سایت فایل یا صفحه ای را درخواست می کند که در سرور موجود نیست، وب سرور خطای ۴۰۴ را برمی گرداند. خطا را همانطور که در زیر توضیح داده شده است، پیدا کرده و برطرف کنید.
- مجوزهای مالکیت وب سرور را به دایرکتوری ریشه وب وردپرس اعطا کنید
$ sudo chown -R www-data:www-data /var/www/html/ - مجوزهای صحیح دایرکتوری و فایل را تنظیم کنید
755دایرکتوری ها:$ sudo find /var/www/html/ -type d -exec chmod 755 {} ;644روی فایل ها:$ sudo find /var/www/html/ -type f -exec chmod 644 {} ; - فهرست طولانی از دایرکتوری ریشه وب تهیه کنید و مقادیر مجوزهای موجود را تأیید کنید
$ ls -l /var/www/html/خروجی:
drwxr-xr-x 9 www-data www-data 4096 Aug 8 20:26 wp-admin -rw-r--r-- 1 www-data www-data 351 May 9 03:17 wp-blog-header.php -rw-r--r-- 1 www-data www-data 2323 Aug 8 20:26 wp-comments-post.php -rw-r--r-- 1 www-data www-data 3360 Jul 27 14:42 wp-config.php -rw-r--r-- 1 www-data www-data 3013 May 9 03:17 wp-config-sample.php drwxr-xr-x 10 www-data www-data 4096 Aug 27 20:53 wp-content -rw-r--r-- 1 www-data www-data 5638 Aug 8 20:26 wp-cron.php drwxr-xr-x 27 www-data www-data 16384 Aug 8 20:26 wp-includes -rw-r--r-- 1 www-data www-data 2502 May 9 03:17 wp-links-opml.php -rw-r--r-- 1 www-data www-data 3927 Aug 8 20:26 wp-load.php -rw-r--r-- 1 www-data www-data 49441 Aug 8 20:26 wp-login.phpسایت وردپرس خود را دوباره بررسی کنید، تأیید کنید که منبع درخواستی روی سرور موجود است و خطا دوباره نمایش داده نمی شود.
- فایل پیکربندی وب سرور وردپرس خود را مشاهده کنید
$ sudo cat /etc/nginx/sites-enabled/example.com - تأیید کنید که پیکربندی به دایرکتوری ریشه وب وردپرس اشاره می کند
root /var/www/html;بسته به وب سرور شما، ممکن است دستورالعمل ریشه وب متفاوت باشد. برای مثال
DocumentRootهنگام استفاده از آپاچی - وارد داشبورد مدیریت وردپرس خود شوید
https://example.com/wp-admin - به تنظیمات > پیوندهای یکتا بروید ، ساختار پیوندهای یکتای وردپرس خود را مجدداً تنظیم کنید تا ساختار URL شما به روزرسانی شود و از خطاهای ۴۰۴ جلوگیری شود.
نحوه رفع خطای HTTP ۵۰۰ Internal Server
- تأیید کنید که وب سرور فعال و در حال اجرا است
$ sudo systemctl status nginx - تأیید کنید که PHP-FPM فعال و در حال اجرا است
$ sudo systemctl status php-fpm - برای بررسی منبع دقیق خطا، گزارش های خطای وب سرور را مشاهده کنید.
$ sudo cat /var/log/nginx/error.log - همچنین، گزارش های خطای PHP-FPM را مشاهده کنید تا تأیید کنید که آیا خطا توسط یک اسکریپت PHP ایجاد نشده است یا خیر.
$ sudo cat /var/log/php-fpm/error.logخروجی:
2023/08/07 12:34:56 [error] 12345#0: *6789 FastCGI sent in stderr: "PHP message: PHP Fatal error: Uncaught Error: Call to undefined function someUndefinedFunction() in /var/www/html/wp-content/custom-plugin.php:23 Stack trace: #0 {main} thrown in /var/www/html/wp-content/custom-plugin.php on line 23" while reading response header from upstream, client: 192.168.1.1, server: example.com, request: "GET /page.php HTTP/1.1", upstream: "fastcgi://unix:/var/run/php/php7.4-fpm.sock:", host: "example.com", referrer: "http://example.com/"
چگونه خطای ۵۰۲ Bad Gateway را برطرف کنیم؟
خطای HTTP ۵۰۲ bad gateway ناشی از اتمام زمان پاسخگویی سرور وب است. وقتی کاربری درخواستی به سایت وردپرس شما ارسال می کند، سرور وب در صورت عدم توانایی در مدیریت درخواست، خطای ۵۰۲ gateway را برمی گرداند. معمولاً وقتی اتصال به PHP-FPM با اتمام زمان پاسخگویی مواجه می شود، سرور وب این خطا را برمی گرداند. منبع خطا را پیدا کنید و آن را مطابق توضیحات زیر برطرف کنید.
- مشاهده آخرین ورودی های گزارش خطای وب سرور
$ sudo cat /var/log/nginx/error.log | tail - آخرین خطا را پیدا کنید. معمولاً ممکن است خطا را پیدا کنید
*1 connect() to unix:/var/run/php-fpm.socket failed (2: No such file or directory) while connecting to upstream. برای رفع آن، پیکربندی وب سرور خود را مشاهده کنید.$ cat /etc/nginx/sites-enabled/example.com - تأیید کنید که پیکربندی های صحیح PHP در این
/.phpبخش موجود است.location ~ .php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php8.1-fpm.sock; } - تأیید کنید که PHP-FPM (بر اساس نسخه شما) فعال و در حال اجرا است
$ sudo systemctl status php8.1-fpmخروجی:
● php8.1-fpm.service - The PHP 8.1 FastCGI Process Manager Loaded: loaded (/lib/systemd/system/php8.1-fpm.service; enabled; vendor preset: enabled) Active: active (running) since Wed 2023-08-30 17:55:55 UTC; 27s ago - اگر خطا همچنان ادامه داشت، پیکربندی PHP-FPM را مشاهده کنید.
$ cat /etc/php/8.1/fpm/pool.d/www.conf - تأیید کنید
user/groupکه به عنوان کاربر وب سرور اجرا می شود.www-data; Unix user/group of processes ; Note: The user is mandatory. If the group is not set, the default user's group ; will be used. user = www-data group = www-data
به سایت وردپرس خود مراجعه کنید و بررسی کنید که خطا دوباره ظاهر نمی شود. وقتی دوباره ظاهر شد، گزارش های خطای وب سرور خود را دوباره مشاهده کنید تا منبع خطا را تأیید کنید.
چگونه خطای ۴۰۳ Forbidden را برطرف کنیم؟
خطای HTTP ۴۰۳ forbidden به دلیل مجوزهای نامناسب برای دسترسی به یک منبع خاص در سرور وردپرس نمایش داده می شود. معمولاً اگر وب سرور امتیاز خواندن منبع را نداشته باشد، این خطا در سایت وردپرس شما نمایش داده می شود. خطا را طبق توضیحات زیر برطرف کنید.
- برای یافتن منبع دقیق خطا، گزارش های خطای وب سرور را مشاهده کنید.
$ sudo cat /var/log/nginx/error.log - فهرست طولانی از دایرکتوری ریشه وب وردپرس تهیه کنید و تأیید کنید که
www-dataکاربر دارای امتیاز خواندن است$ ls -l /var/www/html/خروجی:
drwxr-xr-x 9 www-data www-data 4096 Aug 8 20:26 wp-admin -rw-r--r-- 1 www-data www-data 351 May 9 03:17 wp-blog-header.php -rw-r--r-- 1 www-data www-data 2323 Aug 8 20:26 wp-comments-post.php -rw-r--r-- 1 www-data www-data 3360 Jul 27 14:42 wp-config.php drwxr-xr-x 10 www-data www-data 4096 Aug 27 20:53 wp-content drwxr-xr-x 27 www-data www-data 16384 Aug 8 20:26 wp-includeswww-dataبه کاربر وب سرور امتیازات کامل برای دسترسی به دایرکتوری اعطا کنید .$ sudo chown -R www-data:www-data /var/www/html/ - مجوزهای صحیح دایرکتوری وردپرس را تنظیم کنید
$ sudo find /var/www/html/ -type d -exec chmod 755 {} ; - مجوزهای صحیح فایل وردپرس را تنظیم کنید
$ sudo find /var/www/html/ -type f -exec chmod 644 {} ; - از سایت وردپرس خود بازدید کنید و مطمئن شوید که خطا دوباره نمایش داده نمی شود.
https://example.com
نحوه رفع خطای آپلود: نوشتن فایل روی دیسک ناموفق بود
وقتی وب سرور قادر به نوشتن فایل های جدید آپلود شده از طریق داشبورد وردپرس شما نباشد، این failed to write file to diskخطا نمایش داده می شود. برای رفع خطا، تأیید کنید که وب سرور مجوزهای خواندن و نوشتن در دایرکتوری ریشه وب وردپرس را دارد. مجوزها را مطابق توضیحات زیر تأیید کنید.
- مشاهده مجوزهای دایرکتوری ریشه وب وردپرس
$ ls -l /var/www/html/ - مجوزهای صحیح دایرکتوری را تنظیم کنید
$ sudo find /var/www/html/ -type d -exec chmod 755 {} ; - تنظیم مجوزهای فایل وردپرس
$ sudo find /var/www/html/ -type f -exec chmod 644 {} ;
چگونه خطای «این سایت با مشکلات فنی مواجه است» در وردپرس را برطرف کنیم؟
وقتی وردپرس به آخرین نسخه ارتقا می یابد، site is experiencing technical difficultiesممکن است این خطا نمایش داده شود. دلیل این امر این است که ممکن است برخی از قالب ها یا فایل های افزونه با نسخه جدید سازگار نباشند، منبع دقیق وردپرس را پیدا کنید و خطا را همانطور که در زیر توضیح داده شده است، برطرف کنید.
- تغییر نام
pluginsدایرکتوری بهpluginsold$ sudo mv /var/www/html/wp-content/plugins /var/www/html/wp-content/plugins-old - ایجاد یک
pluginsدایرکتوری جدید$ sudo mkdir /var/www/html/wp-content/plugins pluginsبرای فعال کردن دایرکتوری جدید، به داشبورد وردپرس خود مراجعه کنید.https://example.com/wp-admin- در بخش ترمینال خود، افزونه های قدیمی را یکی یکی کپی کنید. برای مثال،
woocommerceدر صورت وجود، با شروع کنید.$ sudo cp /var/www/html/wp-content/plugins-old/woocommerce /var/www/html/wp-content/pluginsبسته به تعداد افزونه های موجود، ابتدا مهم ترین افزونه ها و در آخر افزونه های مشکوک را کپی کنید.

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

راهنمای عیب یابی وردپرس - در صورتی که خطا ناشی از یک قالب خراب باشد، بررسی کنید که قالب فعال شما از آخرین نسخه وردپرس پشتیبانی می کند، در غیر این صورت، وردپرس خود را به پایدارترین نسخه پشتیبان تهیه شده، دانگرید کنید.
نحوه رفع صفحه سفید مرگ وردپرس (صفحه خالی)
صفحه سفید مرگ وردپرس یک صفحه خالی است که هیچ خطایی را نشان نمی دهد، اما هیچ تعاملی را در سایت وردپرس شما نمی پذیرد. به جای صفحه سفید، There has been a critical error on this websiteممکن است خطا نمایش داده شود، هر دو خطا یکسان هستند و بر عملکرد کلی سایت شما تأثیر می گذارند. معمولاً این خطا به دلیل مشکلات قالب یا افزونه نمایش داده می شود و در زیر اقدامات عیب یابی توصیه شده آمده است.
- همه افزونه های وردپرس را تغییر نام داده و غیرفعال کنید. سپس، آنها را یکی یکی دوباره فعال کنید.
- قالب وردپرس را غیرفعال کنید و به قالب پیش فرض بروید
- اشکال زدایی وردپرس را فعال کنید و گزارش ها را مشاهده کنید
- مشاهده لاگ های وب سرور
- افزایش محدودیت حافظه PHP
- وارد حالت بازیابی وردپرس شوید
برای اطلاعات بیشتر، به عیب یابی صفحه سفید مرگ وردپرس مراجعه کنید.
نتیجه گیری #
در این مقاله، شما مراحل عیب یابی را برای رفع خطاهای رایج وردپرس در سایت خود پیاده سازی کردید. در میان این مراحل، شما اقدامات سرور backend را پیاده سازی کردید که به شما امکان می دهد خطاها را کشف کرده و قبل از اینکه برای بازدیدکنندگان سایت وردپرس شما نمایش داده شوند، روی آنها کار کنید. برای اطلاعات بیشتر، به صفحه خطاهای رایج وردپرس مراجعه کنید .




