DevOps والخوادم

تشخيص حلقات إعادة التوجيه في htaccess: منهجية عملية

الخلاصة سريعاً

  • حلقتان مختلفتان تماماً: خارجية (سلسلة 3xx يراها العميل حتى حد المتصفح ~20 قفزة) وداخلية (إعادة تشغيل mod_rewrite حتى حد Apache الافتراضي 10 → خطأ 500).
  • شكل سلسلة Location في إخراج curl يشخّص السبب غالباً قبل لمس أي قاعدة: تكرار حرفي، تبادل زوجي، أو تصاعد ثم عودة.
  • [L] يوقف الدورة الحالية فقط؛ في سياق .htaccess يُعاد تشغيل الملف كاملاً على الرابط الجديد — من هنا تولد الحلقات الداخلية.
  • أشهر مسبب حديث: شرط %{HTTPS} off خلف CDN/بروكسي ينهي TLS نيابة عنك (Flexible SSL).
  • كل إصلاح يُتحقق منه بأمر curl واحد — لا بـ«يبدو أنه عمل الآن».

تشريح الخطأ: حلقتان لا حلقة واحدة

عندما يرى المستخدم ERR_TOO_MANY_REDIRECTS فذلك حدّ المتصفح (حوالي 20 قفزة في Chrome وFirefox) لسلسلة استجابات 3xx لا تستقر. أما عندما يرى خطأ 500 وفي error_log سطر «Request exceeded the limit of 10 internal redirects due to probable configuration error» فتلك حلقة أخرى تماماً: حلقة داخلية داخل Apache نفسه، يوقفها حد LimitInternalRecursion الافتراضي (10).

الحلقة الخارجيةالحلقة الداخلية
ما يراه العميلERR_TOO_MANY_REDIRECTS بعد سلسلة 301/302HTTP 500 فوري غالباً
أثرها في السجلاتسطر وصول لكل قفزة (3xx متكرر)سطر خطأ LimitInternalRecursion
مكانهابين المتصفح والخادم (أو بين الخادم والوسيط)داخل دورة mod_rewrite لكل طلب
أدوات كشفهاcurl -IL وسلسلة Locationerror_log + rewrite:trace8
إطار الإصلاحشروط القواعد وتعارض الوحدات والوسيطبنية الملف: فتحة escape أو [END]

تمييز النوعين هو الخطوة صفر في المنهجية: كل ما يليها يختلف بحسبه. خلطهما هو سبب ساعات الهدر الكلاسيكية («عدّلت عشر قواعد والمشكلة في وسيط لم أفحصه»). لفهم كيف تتفاعل حلقات إعادة التوجيه مع رؤوس HTTP الأمنية، راجع أداة فحص رؤوس HTTP.

النموذج الذهني: لماذا يعيد mod_rewrite التشغيل؟

في سياق .htaccess (per-directory) لا تُعالَج القواعد مرة واحدة. عندما تُنتج قاعدة استبدالاً داخلياً (بلا [R])، يشغّل Apache طلباً داخلياً جديداً على المسار الناتج، ثم يعيد تشغيل ملف .htaccess كاملاً من أول قاعدة على ذلك المسار. لذلك:

قاعدة التصميم: كل ملف إعادة كتابة يحتاج «فتحة escape» صريحة: قاعدة أولى تُخرج المسارات النهائية من الدورة (مثل RewriteRule ^index\.php$ - [L] في ووردبريس) أو استخدام [END] في القاعدة الخاتمة. ملف بلا فتحة escape هو حلقة داخلية تنتظر حدوثها.

الأنماط الستة الأشهر للحلقات

1. إجبار HTTPS خلف وسيط ينهي TLS (Flexible SSL)

# القاعدة الكلاسيكية... وحلقة كلاسيكية خلف Cloudflare Flexible RewriteCond %{HTTPS} off RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301] # ما يحدث فعلياً: # العميل → CDN عبر HTTPS ✓ # CDN → أصل الخادم عبر HTTP ⇒ %{HTTPS} = off دائماً # الأصل يرد 301 إلى https://... ⇒ CDN يعيد الطلب نفسه ⇒ حلقة # الإصلاح: اشترط ألا يؤكد أي مصدر أن الاتصال HTTPS RewriteCond %{HTTP:X-Forwarded-Proto} !https RewriteCond %{HTTPS} off RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

البديل الأنظف تشغيلياً: ضبط وضع SSL لدى الـ CDN على Full/Full-Strict حتى يرى الأصل TLS حقيقياً، فتبقى القاعدة الأصلية صحيحة بلا استثناءات. يمكنك التحقق من حالة شهادة SSL وإعدادات TLS عبر أداة فحص SSL.

2. قاعدة Canonical بلا شرط: توجيه الرابط إلى نفسه

# ❌ بلا شرط: كل طلب — حتى الصحيح — يُعاد توجيهه إلى نفسه RewriteRule ^(.*)$ https://example.com/$1 [R=301,L] # ✅ الشرط هو ما يكسر الحلقة: وجّه فقط حين يختلف المضيف RewriteCond %{HTTP_HOST} !^example\.com$ [NC] RewriteRule ^(.*)$ https://example.com/$1 [R=301,L]

3. شرطة النهاية ضد mod_dir

mod_dir (عبر DirectorySlash On الافتراضي) يُصدر 301 لإضافة شرطة نهاية لأي مجلد حقيقي يُطلب بدونها. إذا كانت قاعدتك تحذف الشرطة، يصير الاثنان خصمين يتبادلان الطلب:

# ❌ /products/ مجلد حقيقي: القاعدة تحذف، mod_dir يعيد، وهكذا RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.+?)/$ /$1 [L,R=301] # ✅ استثنِ المجلدات الحقيقية من الحذف RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.+?)/$ /$1 [L,R=301]

4. Front controller بلا فتحة escape (حلقة داخلية)

# ❌ دورة 1: /page → index.php | دورة 2: index.php يطابق النمط نفسه # → إعادة كتابة إلى index.php مجدداً × 10 → 500 RewriteRule ^(.*)$ index.php [L] # ✅ نمط ووردبريس: فتحة escape أولاً + شروط وجود الملف RewriteRule ^index\.php$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.php [L] # ✅ أو حسم بدورة واحدة RewriteRule ^(.*)$ /index.php [END]

5. شرط Query String لا يستقر مع QSA

الشروط المثبّتة على بداية سلسلة الاستعلام (!^lang=) مع علم [QSA] وصفة تبادل: كل قاعدة ترتّب المعاملات بشكل مختلف، فتعود شروط القاعدة الأخرى للتحقق، وهكذا:

# ❌ قاعدتان تتبادلان الترتيب بلا استقرار RewriteCond %{QUERY_STRING} !^lang= RewriteRule ^ /$1?lang=ar [R=302,L,QSA] RewriteCond %{QUERY_STRING} !^utm= RewriteRule ^ /$1?utm=none [R=302,L,QSA] # ✅ افحص الوجود في أي موضع، وادمج التعديلات في قاعدة واحدة RewriteCond %{QUERY_STRING} !lang= RewriteRule ^ /$1?lang=ar [R=302,L,QSA]

6. ping-pong بين mod_alias وmod_rewrite

# ❌ وحدتان مختلفتان تتبادلان العنوان عبر الطلبات Redirect 301 /old /new # mod_alias (طور translate) RewriteRule ^new/?$ /old [R=301,L] # mod_rewrite (طور fixup) — قاعدة منسية # ✅ مصدر حقيقة واحد لكل مسار: احذف إحدى الوحدتين Redirect 301 /old /new

الترتيب داخل الطلب الواحد: توجيهات mod_alias تُقيَّم في طور ترجمة الاسم قبل قواعد mod_rewrite على مستوى المجلد — لكن الحلقة هنا تعيش عبر الطلبات، لذا لا يظهر تعارض في أي تمريرة واحدة، ويصعب رؤيته بدون سلسلة Location كاملة.

منهجية التشخيص في ست خطوات

  1. اطبع السلسلة كما يراها العميل:
    curl -sIL --max-redirs 30 https://example.com/products/ \ | grep -E '^(HTTP/|location:)'
    شكل السلسلة هو نصف التشخيص (انظر الجدول المرجعي أدناه). يمكنك أيضاً استخدام أداة فاحص إعادة التوجيه لتتبع السلسلة بصرياً حتى 10 قفزات مع تحليل SEO ذكي.
  2. صنّف الحلقة: خارجية (سلسلة 3xx مرئية) أم داخلية (500 + سطر LimitInternalRecursion):
    grep -E 'exceeded the limit of 10 internal redirects|LimitInternalRecursion' \ /var/log/apache2/error.log | tail -5
  3. افصل طبقات الوسيط: كرر الفحص متجاوزاً الـ CDN (على IP الأصل مع Host: و--resolve) وقارن:
    curl -sI --resolve example.com:443:203.0.113.10 \ https://example.com/products/ | grep -E '^(HTTP/|location:)'
    اختلاف السلوك بين المسارين يعني أن الحلقة تعيش في طبقة الوسيط أو في تفاعله مع الأصل. لمعرفة IP الخادم الحقيقي، استخدم أداة فحص IP أو أداة تحويل Hostname إلى IP.
  4. اختبر المتغيرات المشبوهة: قارن %{HTTPS} و%{HTTP:X-Forwarded-Proto} و%{HTTP_HOST} بين بيئتيك؛ خلف وسيط، اطبعها مؤقتاً برأس تشخيصي أو افحصها بالمحاكي.
  5. عزل ثنائي للقواعد: علّق نصف الملف وأعد الفحص، ثم نصف المتبقي... حتى تنهار الحلقة. القاعدة التي بإزالتها تنكسر الحلقة هي نصف التشخيص؛ نصفه الثاني هو الشرط الذي جعلها تعمى عن حالتها النهائية.
  6. أكّد الإصلاح بأمر واحد: نفس curl الخطوة 1 يجب أن يُنهى بـ 200 (أو 3xx واحدة مشروعة ثم 200). لا تعتمد على متصفح كان قد خزّن 301 قديمة — اختبر بوضع خاص أو curl.

فخ الكاش: المتصفحات تخزّن 301 بعناد. بعد إصلاح حلقة، قد يستمر «الخطأ» لدى المستخدمين (ولديك) بسبب كاش التوجيه لا بسبب الخادم. اختبر دائماً بمصدر غير مخزّن، وذكّر فريق الدعم أن يطلب تجربة نافذة خاصة قبل تصعيد أي بلاغ بعد الإصلاح.

rewrite:trace8 دون غرق

لتشخيص الحلقات الداخلية لا بديل عن تتبع mod_rewrite نفسه (Apache 2.4):

# في تكوين الخادم أو .htaccess إن سُمح — وعلى staging أولاً LogLevel alert rewrite:trace8 # نموذج مما يظهر لكل دورة (لاحظ pass المتصاعد): [rewrite:trace3] mod_rewrite.c(480): applying pattern '^(.*)$' to uri '/index.php' [rewrite:trace2] mod_rewrite.c(480): rewrite '/index.php' -> 'index.php' [rewrite:trace1] mod_rewrite.c(480): pass 2, /var/www/html [rewrite:trace3] mod_rewrite.c(480): applying pattern '^(.*)$' to uri '/index.php' ... # تكرار نفس uri مع تصاعد pass = حلقتك الداخلية أمام عينيك

لمزيد من تقنيات استخراج الأنماط من سجلات الأخطاء، اقرأ مقال قراءة error_log كمدير أنظمة.

حالة دراسية: ثلاثة تعارضات في ملف واحد

موقع خلف CDN بوضع Flexible، وملف htaccess يجمع ثلاث قواعد «صحيحة منفردة»:

RewriteCond %{HTTPS} off RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301] # (أ) RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC] RewriteRule ^ https://%1%{REQUEST_URI} [L,R=301] # (ب) RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.+?)/$ /$1 [L,R=301] # (ج) بلا !-d

سلسلة curl الفعلية لطلب https://www.example.com/products/:

HTTP/2 301 location: https://example.com/products/ # (ب) تعمل HTTP/2 301 location: https://example.com/products/ # (أ) حلقة: %{HTTPS} off خلف Flexible HTTP/2 301 location: https://example.com/products # (ج) تحذف الشرطة HTTP/2 301 location: https://example.com/products/ # mod_dir يعيدها ... ERR_TOO_MANY_REDIRECTS

القراءة المنهجية: التكرار الحرفي في القفزتين 1-2 يكشف (أ)؛ التبادل الزوجي في 3-4 يكشف (ج) ضد mod_dir. الإصلاح الثلاثي: وضع Full لدى الـ CDN، وإضافة شرط X-Forwarded-Proto احتياطاً، وإضافة !-d إلى (ج). بعد الإصلاح: 301 واحدة (www) ثم 200.

جدول مرجعي: شكل السلسلة ← السبب ← الإصلاح

شكل السلسلةالسبب الأرجحأول إصلاح تجربه
نفس URL يتكرر حرفياًقاعدة بلا شرط، أو شرط دائم التحقق (Flexible SSL)أضف شرطاً يكسر الذاتية / افحص X-Forwarded-Proto
تبادل /x/ ↔ /xقاعدة شرطة النهاية ضد mod_dirأضف !-d أو اقبل الشرطة للمجلدات
تبادل /old ↔ /newmod_alias ضد mod_rewrite أو قاعدتا مضيف متعارضتانوحّد مصدر التوجيه لوحدة واحدة
500 + «limit of 10 internal redirects»إعادة تشغيل per-dir بلا فتحة escapeقاعدة escape أولى أو [END]
حلقة على صفحات التطبيق فقطتوجيه على مستوى التطبيق (جلسات/صلاحيات) لا htaccessافحص منطق redirect في الكود
حلقة بعد تفعيل HSTS مباشرةHSTS يفرض https على اتصال وسيط غير مكتملأصلح سلسلة TLS/وضع الـ CDN قبل HSTS. اقرأ مقال HSTS Preload

أثر الحلقات والسلاسل على SEO

قائمة منع قبل النشر

  1. كل قاعدة توجيه لها شرط خروج مثبت (مضيف/مسار/بروتوكول) — لا قاعدة «عامة» بلا شرط.
  2. ملف per-dir يحتوي فتحة escape صريحة أو يستخدم [END] في خاتمته.
  3. مصدر حقيقة واحد لكل مسار: mod_alias أو mod_rewrite، لا الاثنان.
  4. توثيق топولوجيا الوسيط (من ينهي TLS؟ ما الرؤوس الممررة؟) بجانب الملف في المستودع.
  5. محاكاة الملف ضد روابط تمثل الحالات الحدّية (جذر، مجلد، ملف، استعلام) عبر أداة اختبار htaccess قبل الرفع — محاكيها يطبق حد 10 دورات نفسه فتظهر الحلقة الداخلية قبل الإنتاج.
  6. بعد النشر: curl تحقق نهائي + مراقبة معدل 3xx في السجلات لمدة 24 ساعة. يمكنك أيضاً فحص حالة الموقع الشاملة عبر فاحص حالة الموقع.

المرجعيات الأساسية: توثيق Apache لـ mod_rewrite (قسم per-directory وقسم الأعلام)، توثيق mod_dir (DirectorySlash)، توثيق LogLevel ووحدات التتبع، RFC 7231 §6.4 (دلالات 301/302)، RFC 7538 (308). لتتمة طبيعية: اقرأ مقالنا عن قراءة error_log كمدير أنظمة.

فريق WaselCheck

فريق يدير خوادم Apache خلف وسائط متعددة، وقضى ليالي كافية مع ERR_TOO_MANY_REDIRECTS ليكتب هذا المقال مختصراً. نوثّق الأخطاء قبل النجاحات لأنها الأكثر فائدة للقارئ.

مقالات وأدوات ذات صلة