خطای 404 صفحه سبد یعنی route نهایی به صفحه معتبر نرسیده است؛ این با «سبد خالی» فرق دارد. ممکن است Cart حذف یا Draft شده، در تنظیمات ووکامرس صفحه دیگری انتخاب شده، slug تعارض داشته یا ruleهای rewrite پس از migration یا تغییر permalink به‌روز نشده باشند.
پاسخ سریع: URL و redirect نهایی را ثبت کنید، وجود و Published بودن صفحه Cart و انتساب آن در تنظیمات ووکامرس را تأیید کنید. سپس slug و تعارض route را بررسی و permalink را از پنل یک‌بار ذخیره کنید. در Nginx فایل .htaccess اثری ندارد و config فعال باید بررسی شود.
اول مطمئن شوید 404 واقعی است
status را در Network یا header پاسخ ببینید. بعضی قالب‌ها متن «پیدا نشد» را با status 200 و برخی CDNها 404 cacheشده نشان می‌دهند. redirect به دامنه یا زبان دیگر نیز ممکن است مقصد را خراب کند. URL اولیه، Locationها و مقصد نهایی را نگه دارید.
صفحه Cart و انتساب آن
در تنظیمات پیشرفته ووکامرس صفحه انتخاب‌شده برای Cart را ببینید. رکورد باید وجود داشته، Published و در زبان درست قابل دسترس باشد. محتوا بسته به نسخه ممکن است block یا shortcode باشد؛ روش استاندارد همان نسخه را حفظ کنید و صفحه تصادفی جدید نسازید.
Slug و تعارض مسیر
صفحه دیگر، taxonomy، endpoint ترجمه یا redirect قدیمی ممکن است slug یکسان داشته باشد. Trash را هم بررسی کنید. تغییر slug روی production لینک منو و canonical را متاثر می‌کند؛ redirect لازم را پیش از تغییر مشخص کنید.
بازسازی Rewrite کم‌ریسک
پس از backup، رفتن به Settings → Permalinks و ذخیره بدون تغییر می‌تواند ruleها را regenerate کند. این اقدام config اشتباه Nginx یا plugin conflict را حل نمی‌کند. .htaccess را حذف نکنید؛ ممکن است rule امنیتی داشته باشد.
Apache و Nginx یکسان نیستند
| وب‌سرور | محل Rewrite | نکته |
|---|---|---|
| Apache | VirtualHost و احتمالاً .htaccess | AllowOverride و module مهم است |
| Nginx | server/location config | .htaccess خوانده نمی‌شود |
| Managed/CDN | پنل provider و origin | redirect/cache دو لایه را جدا کنید |
config اینترنتی را بدون دانستن document root جایگزین نکنید. پیش از reload، syntax را با ابزار همان نسخه بررسی و rollback آماده کنید.
Cache و 404 قدیمی
پس از اصلاح route، CDN یا page cache ممکن است 404 قبلی را نگه دارد. headerها را بررسی و فقط URL مربوط را purge کنید. Cart باید از page cache عمومی bypass باشد.
زبان و ترجمه
در سایت چندزبانه ممکن است صفحه Cart برای یک زبان mapping نشده باشد. assignment، translation relation، slug و fallback را بررسی کنید. کپی صفحه بدون اتصال ترجمه، canonical نامشخص می‌سازد.
پس از Migration
search/replace ناقص، base URL قدیمی، config مقصد یا cache مبدا علت‌های رایج‌اند. serialized data را با replace متنی ساده ویرایش نکنید. DNS را نیز بررسی کنید تا کاربر بین دو سرور نچرخد.
Log وب‌سرور چه کمکی می‌کند؟
access log نشان می‌دهد درخواست به چه path و statusی رسیده و error log ممکن است loop یا file/path اشتباه را روشن کند. timestamp، host و request ID را با مرورگر تطبیق دهید. Query string، cookie و IP مشتری را پیش از اشتراک‌گذاری ناشناس‌سازی کنید. نبودن request در origin معمولاً توجه را به CDN یا DNS می‌برد.
Block یا Shortcode را کورکورانه جایگزین نکنید
نوع صفحه سبد به نسخه و معماری Checkout فروشگاه وابسته است. جایگزینی block با shortcode ممکن است افزونه‌های پرداخت، analytics یا template سفارشی را متاثر کند. ابتدا مستندات نسخه، overrideهای قالب و محیط staging را بررسی کنید و صحت سبد، coupon، ارسال و انتقال به Checkout را بسنجید.
Canonical، منو و Redirect
بعد از تغییر slug، لینک منو، دکمه مشاهده سبد، sitemap و canonical را بررسی کنید. redirect باید فقط URL قدیمی را به Cart معتبر ببرد و loop زبان یا HTTPS نسازد. redirect همه 404ها به صفحه اصلی خطا را پنهان می‌کند و تجربه و تشخیص را بدتر می‌سازد.
فرایند تشخیص
- status و redirect chain را ثبت کنید.
- Cart و وضعیت انتشار را تأیید کنید.
- انتساب صفحه ووکامرس را ببینید.
- slug، Trash و تعارض route را پیدا کنید.
- روی staging permalink را regenerate کنید.
- config فعال و log request را بررسی کنید.
- cache هدفمند را purge و دوباره تست کنید.
Smoke Test
- افزودن محصول ساده و متغیر
- باز کردن Cart از منو و URL مستقیم
- تغییر تعداد و حذف کالا
- مهمان و کاربر واردشده
- زبان‌ها و hostname اصلی
- ورود به Checkout و بازگشت
اگر صفحه باز می‌شود اما سبد خالی است، route حل شده و باید session و cookie سبد را جدا بررسی کنید.
اشتباه‌های رایج
- ساخت چند صفحه Cart
- حذف
.htaccessبدون backup - اصلاح Nginx با
.htaccess - تغییر slug بدون redirect
- cache عمومی Cart
- ویرایش مستقیم option در دیتابیس
چه زمانی کمک تخصصی لازم است؟
اگر 404 فقط پشت CDN، در یک زبان یا بعد از migration رخ می‌دهد، چند لایه routing درگیرند. پشتیبانی فروشگاه ووکامرس می‌تواند mapping، rewrite، proxy و cache را با rollback بررسی کند.
پرسش‌های متداول
آیا ذخیره Permalink امن است؟
معمولاً ruleها را regenerate می‌کند، اما backup و بررسی config سفارشی لازم است.
چرا Cart فارسی 404 و انگلیسی سالم است؟
رابطه ترجمه، انتساب صفحه و slug فارسی را بررسی کنید.
چرا پس از اصلاح هنوز 404 می‌بینم؟
ممکن است CDN یا reverse proxy پاسخ قدیمی را cache کرده باشد؛ purge هدفمند انجام دهید.