همه مقالات تخصصی

خطای ERR_TOO_MANY_REDIRECTS در وردپرس: پیدا کردن حلقه با curl و WP-CLI

حلقهٔ ریدایرکت وردپرس را با curl ردیابی کنید، siteurl و home را با WP-CLI بررسی کنید و هدر X-Forwarded-Proto را پشت پروکسی درست تنظیم کنید.

خطای ERR_TOO_MANY_REDIRECTS در وردپرس: پیدا کردن حلقه با curl و WP-CLI

پیام «این صفحه شما را بیش‌ازحد ریدایرکت کرده است» یعنی دو قانون هم‌زمان یکدیگر را خنثی می‌کنند: مثلاً وردپرس می‌خواهد HTTPS باشد و پروکسی یا سرور به HTTP برمی‌گرداند. راه حل رندوم‌کردن افزونه‌ها نیست؛ باید زنجیره را دید.

۱. زنجیرهٔ ریدایرکت را ببینید

curl -sIL --max-redirs 8 https://example.com/ | grep -iE '^HTTP|^location'

اگر آدرس‌ها بین دو حالت (مثلاً http و https یا www و non-www) رفت‌وبرگشت می‌کنند، همان دو قانونِ درگیر را پیدا کرده‌اید. مرورگر ممکن است ریدایرکت‌های قدیمی را کش کرده باشد، پس curl قابل‌اعتمادتر است.

۲. siteurl و home

wp option get siteurl
wp option get home

این دو باید آدرس نهایی و یکسان (با همان https و همان www) باشند. تصحیح با wp option update home 'https://example.com' ممکن است. اگر پیش از اجرای دستور نیاز به پشتیبان دارید، WP-CLI را ببینید. می‌توانید در wp-config.php هم WP_HOME و WP_SITEURL را صریحاً تعریف کنید.

۳. پشت پروکسی یا CDN

if ( isset( $_SERVER['HTTP_X_FORWARDED_PROTO'] ) && 'https' === $_SERVER['HTTP_X_FORWARDED_PROTO'] ) {
    $_SERVER['HTTPS'] = 'on';
}

اگر TLS در پروکسی تمام می‌شود و به سرور اصلی HTTP می‌رسد، وردپرس فکر می‌کند HTTPS نیست و دوباره ریدایرکت می‌کند. این قطعه را فقط در صورتی بگذارید که مطمئنید هدر از پروکسی قابل‌اعتماد می‌آید. برای حالت Cloudflare Flexible نیز تنظیم SSL را بررسی کنید.

۴. قانون‌های تکراری

ریدایرکت می‌تواند هم‌زمان در .htaccess، افزونهٔ SSL، تنظیم سرور و CDN وجود داشته باشد. یکی را نگه دارید. برای بررسی افزونه‌ها، یکی‌یکی غیرفعال کنید (نه همه با هم روی سایت زنده).

۵. بعد از رفع

کوکی‌ها و کش مرورگر را پاک کنید و دوباره با curl تأیید کنید. تنظیم‌های ثابت را در wp-config.php مستند کنید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید curl بین http و https رفت‌وبرگشت می‌کرد. wp option get home آدرس http را نشان داد در حالی که siteurl با https بود. هماهنگ‌کردن هر دو، حلقه را شکست. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • غیرفعال‌کردن همهٔ افزونه‌ها روی سایت زنده.
  • تکیه بر مرورگری که ریدایرکت را کش کرده.
  • افزودن قانون ریدایرکت سوم بدون برداشتن قبلی.
  • اعتماد به X-Forwarded-Proto بدون پروکسی مطمئن.

۸. پرسش‌های متداول

چرا فقط wp-admin حلقه می‌شود؟ قوانین FORCE_SSL_ADMIN یا افزونه‌ها ممکن است فقط مدیریت را درگیر کنند.

آیا حذف کوکی کمک می‌کند؟ گاهی؛ ولی ریشه معمولاً تنظیم آدرس یا پروکسی است.

WP_HOME با siteurl چه فرقی دارد؟ هر دو آدرس را در wp-config ثابت می‌کنند و مقدار دیتابیس را نادیده می‌گیرند.

۹. چک‌لیست سریع

  1. زنجیرهٔ ریدایرکت با curl دیده شد.
  2. siteurl و home یکسان‌اند.
  3. پروکسی/CDN و هدر پروتکل بررسی شد.
  4. فقط یک لایهٔ ریدایرکت باقی ماند.
  5. کش و کوکی پاک و دوباره تست شد.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

WordPress: editing wp-config.php · WP-CLI: wp option · curl manual