آشنایی با رایج ترین خطا های ووکامرس و نحوه رفع آنها

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

رایج ترین خطاهای ووکامرس

• خطای ۵۰۰ Internal Server Error
• خطای ۴۰۴ Not Found
• خطای اتصال به پایگاه داده (Error Establishing a Database Connection)
• خطای Connection Timed Out
• خطای Maximum Execution Time Exceeded
• خطای PHP Fatal Error: Out of Memory
• خطای Invalid Response (کد وضعیت ۴۰۳)

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

سریع‌ترین راهکارهای رفع خطاهای رایج ووکامرس چیست؟ 

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

۱. صفحه را رفرش کنید

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

ترفند سریع: کافی‌است کلید «F5» یا «Ctrl + R» را فشار دهید. شاید همین یک حرکت ساده، سایت را دوباره به حالت عادی برگرداند.

۲. زیروبم افزونه‌ها را درآورید

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

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

۳. قالب را بررسی کنید

گاهی ناسازگاری قالب با افزونه‌ها باعث ایجاد خطاهایی مانند خطای ۵۰۰ می‌شود. برای بررسی:  

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

بیشتر بخوانید: آموزش افزایش امنیت وردپرس و سایت با ۱۹ راهکار عملی 

رفع خطاهای رایج ووکامرس؛ ارور ۵۰۰ Internal Server

از آن خطاهایی است که ووکامرس فارسی شما را با آن غافل‌گیر می‌کند. خطای ۵۰۰ Internal Server Error یعنی سرور با مشکلی غیرمنتظره روبه‌رو شده و نمی‌تواند درخواست شما را انجام دهد. اما جای نگرانی نیست. خطا ۵۰۰ دلیل مشخصی را نشان نمی‌دهد؛ بنابراین برای پیدا کردن علت دقیق آن باید به لاگ‌های خطای سرور مراجعه کنید. اما به‌طور کلی، موارد زیر می‌توانند عامل ایجاد این خطا باشند:  

• مشکلات افزونه یا قالب  
• فایل .htaccess خراب یا ناقص  
• مشکلات پایگاه داده یا کش (Cache)  
• محدودیت حافظه PHP  
• مشکلات هاست یا سرور  

مطلب مرتبط: تفاوت هاست و سرور چیست؟ معرفی کامل فرق هاست با سرور

راهکار رفع خطای ۵۰۰ ووکامرس

برای رفع این خطا چند عامل را باید بررسی کنید:

۱. بررسی لاگ‌های خطا

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

۲. به‌روزرسانی نسخه PHP

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

 ۳. افزایش حافظه PHP

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

رفع خطاهای رایج ووکامرس؛ ارور ۴۰۴ در ووکامرس

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

• لینک‌های شکسته (Broken Links): زمانی که لینک به صفحه‌ای اشاره می‌کند که دیگر وجود ندارد یا آدرس آن تغییر کرده است.
• تغییر URL: اگر آدرس صفحه‌ای تغییر کند و لینک‌ها به آدرس قبلی اشاره کنند، خطای ۴۰۴ نمایش داده می‌شود.
• فایل .htaccess: اگر از وب‌سرور Apache استفاده می‌کنید، احتمالا مشکل از فایل .htaccess است که وظیفه مدیریت ساختار لینک‌های سایت شما را برعهده دارد. گاهی این فایل ممکن است به اشتباه لینک‌ها را به مسیرهای نادرست هدایت کند.

برای رفع این مشکل می‌توانید این مراحل را دنبال کنید:

• بررسی لینک‌ها: لینک‌های صفحه را چک کنید و مطمئن شوید به صفحات صحیح هدایت می‌شوند.
• بررسی تغییرات URL: اگر آدرس صفحات تغییر کرده، لینک‌های داخلی و خارجی را به آدرس‌های جدید به‌روزرسانی کنید. در این زمینه، می‌توانید از ابزارهای سئو برای بررسی لینک‌ها استفاده کنید. 
• تنظیم مجدد .htaccess: اگر از Apache استفاده می‌کنید، فایل .htaccess (فایل htaccess کجاست؟) را بازبینی کنید. گاهی بازبینی این فایل می‌تواند مشکل را حل کند. برای این کار در پنل مدیریت هاست فایل .htaccess را پیدا کنید.

رفع خطاهای ووکامرس: خطای اتصال به پایگاه داده در ووکامرس

خطای اتصال به پایگاه داده در ووکامرس یا Error Establishing a Database Connection زمانی رخ می‌دهد که سایت شما نتواند به پایگاه داده‌اش دسترسی پیدا کند. اگر این ارتباط برقرار نشود، سایت شما عملا از کار می‌افتد. مقصر اصلی این خطا معمولا یک فایل حیاتی به نام wp-config.php است. این فایل اطلاعات مهمی مانند نام پایگاه داده، نام کاربری، رمز عبور و سرور را ذخیره می‌کند. اگر هر کدام از این اطلاعات اشتباه باشد، سایت نمی‌تواند به پایگاه داده متصل شود.

برای رفع ارور error establishing a database connection در وردپرس به‌صورت زیر اقدام کنید: 

۱. بررسی اطلاعات فایل wp-config.php

ابتدا باید اطلاعاتی که در فایل wp-config.php ذخیره شده را بررسی کنید. این اطلاعات شامل موارد زیر است:

• نام پایگاه داده (DB_NAME)
• نام کاربری (DB_USER)
• رمز عبور (DB_PASSWORD)
• هاست یا سرور پایگاه داده (DB_HOST)

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

۲. تماس با پشتیبانی هاست

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

رفع ارورهای رایج ووکامرس؛ خطای Connection Timed Out

خطای Connection Timed Out یکی از بدقلق‌ترین و بدموقع‌ترین خطاهای ووکامرس نشان می‌دهد سایت شما نتوانسته در زمان مناسب به سرور Printful وصل شود. یکی از شایع‌ترین دلایل این خطا، کمبود منابع سرور است. اگر سایت شما از هاست اشتراکی (هاست اشتراکی چیست؟) استفاده می‌کند، ممکن است منابع سرور توسط سایت‌های دیگر اشغال شده باشند. همچنین، ممکن است سایتتان از حداکثر پهنای باند اختصاصی عبور کرده باشد.

راهکارهای پیشنهادی

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

رفع خطای رایج ووکامرس؛ خطای Maximum Execution Time Exceeded

این ارور Maximum Execution Time Exceeded در ووکامرس معمولا به‌دلیل پردازش سنگین کد یا محدودیت زمانی تعیین‌شده توسط هاستینگ رخ می‌دهد. دلایل اصلی آن شامل موارد زیر است:

• منابع سرور شما محدود شده است.
• از افزونه‌های سنگین یا ناسازگار استفاده کردید.
• در بک‌اند سایت وردپرس شما پردازش‌های طولانی یا پیچیده انجام گرفته است.

راهکار رفع خطای ۳۰ ثانیه

اولین و بهترین کار این است که با پشتیبانی هاستینگ تماس بگیرید. تیم هاستینگ می‌تواند مشکل را شناسایی کند و محدودیت زمان اجرای PHP را برای شما افزایش دهد. از پشتیبانی بخواهید مقدار PHP Max Execution Time را برای سایت شما افزایش دهند (مثلاً به ۶۰۰ ثانیه یا بیشتر).

رفع خطاهای رایج ووکامرس؛ ارور PHP Fatal error: Out of memory

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

۱. وارد پوشه اصلی سایت خود در هاست شوید (این پوشه معمولاً با نام root یا public_html شناخته می‌شود). فایل wp-config.php را پیدا کنید.

۲. روی فایل wp-config.php راست کلیک کرده و گزینه View/Edit را انتخاب کنید.

۳. فایل را با یک ویرایشگر متنی باز کنید. سپس عبارت زیر را به فایل اضافه کنید:

;define( 'WP_MEMORY_LIMIT', '256M' )

این کد، حافظه PHP را به ۲۵۶ مگابایت افزایش می‌دهد.

۴. فایل را ذخیره کرده و صفحه سایت خود را دوباره بارگذاری کنید تا ببینید مشکل حل شده است یا خیر.

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

رفع خطا های رایج ووکامرس؛ کد ۴۰۳ یا دریافت پاسخ نامعتبر از فروشگاه

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

• برخی تنظیمات سرور ممکن است هدرهای Basic Authentication را حذف کرده یا جلوی دسترسی به API‌های ووکامرس را بگیرند.
• سرور اجازه دسترسی به آدرس‌های مهم ووکامرس را نمی‌دهد.
• افزونه‌های نصب‌شده کار را خراب کردند.
• مشکلات ناشی از ماژول PHP-FPM.

راهکار رفع خطا:

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

خطاهای رایج ووکامرس؛ قالب و افزونه Plugins and Themes Squabble

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

«یک خطای مهم در این وب سایت رخ داده است. لطفاً صندوق ایمیل مدیر سایت را برای دستورالعمل بررسی نمایید»

راهکار پیشنهادی:

تمام افزونه‌ها را غیرفعال کنید و سپس یکی یکی آن‌ها را فعال کنید تا افزونه‌ خاطی را پیدا کنید.

رفع خطای ووکامرس؛ ارور session_start

با خطایی مانند پیغام زیر روبه‌رو شدید؟

:Warning: session_start() [function.session-start]: open(xxx) failed
Permission denied (13) in xxx/wp-content/plugins/woocommerce/woocommerce.php
on line 80

این خطا از تنظیمات اشتباه در PHP یا دسترسی نداشتن به پوشه مربوط به session حکایت می‌کند.

راهکار پیشنهادی:

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

رفع خطاهای رایج ووکامرس: خطای Call to Undefined Function: is_woocommerce_active()

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

راهکار پیشنهادی:

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

رفع خطای ووکامرس؛ نمایش ندادن لینک دانلود در ایمیل سفارشات

گاهی ممکن است لینک‌ دانلود محصولات دیجیتال شما در ایمیل سفارش نمایش داده نشوند. این مشکل به دلیل طولانی بودن پیشوند جداول پایگاه داده (Table Prefix) رخ می‌دهد. اگر پیشوند جداول شما بیش از ۶۴ کاراکتر باشد، برخی از جداول ضروری مانند «wp_woocommerce_downloadable_product_permissions» به‌درستی ساخته نمی‌شوند.

راهکار پیشنهادی:

از افزونه‌ای مانند DB Prefix Change برای کوتاه کردن پیشوند جداول پایگاه داده (دیتابیس چیست؟) استفاده کنید.

رفع خطاهای رایج ووکامرس؛ نمایش تار تصاویر محصولات

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

در ووکامرس، سه نوع تصویر اصلی داریم:

۱. تصویر شاخص محصول (Single Product Image)

بزرگ‌ترین تصویر نمایش داده‌شده در صفحه جزئیات محصول است. برای پیدا کردن اندازه پیش‌فرض آن:

• وارد فروشگاه شوید و یک محصول را باز کنید.
• روی تصویر بزرگ محصول کلیک راست کنید و Inspect را بزنید. ابعاد تصویر نمایش داده می‌شود.

۲. تصاویر کاتالوگ (Catalog Images)

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

• به صفحه فروشگاه بروید.
• روی هر تصویر متوسط کلیک راست کنید و ابعاد را ببینید.

۳. تصاویر کوچک (Product Thumbnails)

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

راهکار پیشنهادی:

حالا که ابعاد پیش‌فرض قالب خود را پیدا کردید، مراحل زیر را دنبال کنید:

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

نکته حرفه‌ای:

رفع خطاهای رایج ووکامرس؛ مشکلات درگاه پرداخت در ووکامرس

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

• تنظیمات نادرست درگاه پرداخت و نداشتن گواهی SSL
• مشکلات مربوط به HTTPS
• تنظیمات نادرست URL در ووکامرس

راهکارهای پیشنهادی

۱.  مطمئن شوید گواهی‌نامه TLS/SSL شما به‌درستی پیکربندی شده باشد. سایت‌های فروشگاهی بدون SSL یا TLS نمی‌توانند به‌درستی عمل کنند و حتی ممکن است باعث اختلال در فرآیند پرداخت شوند. پس حتما گواهی SSL خود را دریافت کنید.

۲. پس از نصب گواهی SSL، لازم است URL‌های ووکامرس خود را به‌روزرسانی کنید. برای این کار، به بخش تنظیمات > عمومی بروید. پروتکل https:// را اضافه و تغییرات را ذخیره کنید.

۳.  اگر از پلاگین SSL اضافی استفاده می‌کنید، ممکن است با حلقه‌های ریدایرکت مواجه شوید. برای رفع این مشکل، پلاگین اضافی را حذف و تنظیمات «Force SSL» را غیرفعال کنید.

مطلب مرتبط: تفاوت ssl و tls چیست؟ کدام یک را انتخاب کنیم؟

جمع بندی:

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

سوالات متداولی که شما می‌پرسید؟

۱. چرا ووکامرس من کار نمی‌کند؟

مشکل کار نکردن ووکامرس ممکن است دلایل مختلفی داشته باشد، مثل:

• ناسازگاری بین قالب و افزونه‌ها
• نسخه‌های قدیمی افزونه یا وردپرس
• مشکلات سرور
• تنظیمات اشتباه سرور یا سایت

۲. چطور خطاهای ووکامرس را بررسی کنم؟

برای بررسی خطاهای ووکامرس:

• حالت دیباگ وردپرس را در فایل wp-config.php فعال کنید.
• پیام‌های خطا را در سایت یا فایل لاگ خطا ببینید.
• از ابزارهای مرورگر (مثل کنسول یا شبکه) برای بررسی خطاهای JavaScript یا AJAX استفاده کنید

منابع:

cloudways

printful

printful

fixrunner

wpswings