إصلاح · الصفحات والهاتف والعربية
خطأ hydration: النص لا يطابق ما رسمه الخادم
ما قد تراه
- تقول وحدة التحكم إن hydration فشل أو أن النص لا يطابق
- يومض تاريخ أو رقم أو قيمة عشوائية عند التحميل
السبب الأرجح
تختلف الصفحة التي رسمها الخادم عمّا يرسمه المتصفح أولاً، غالباً بسبب التواريخ أو القيم العشوائية أو بيانات المتصفح فقط أو تداخل غير صالح مثل div داخل p.
افحص أولاً (نحو دقيقتين)
- اقرأ الرسالة: هل تذكر مشكلة تداخل عناصر (مثل div داخل p)؟
- هل تعرض الوقت الحالي أو معرّفاً عشوائياً أو محتوى localStorage مباشرة أثناء الرسم؟
أمر الإصلاح
ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.
يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.
لغة الأمر
الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.
بعد أن جرّبته، هل نجح؟
الخطوات
- اعثر على المكوّن المذكور في الرسالة.
- اعثر على القيم التي تختلف بين الخادم والمتصفح (Date وMath.random وwindow وlocalStorage واللغة أو المنطقة الزمنية) وانقلها إلى effect يعمل بعد التحميل أو ارسمها بالشكل نفسه على الطرفين.
- أصلح تداخل HTML غير الصالح (div داخل p أو رابط داخل رابط أو زر داخل زر).
- إن كانت إضافة متصفح تعدّل الصفحة فاختبر في نافذة خاصة أولاً.
لا تفعل هذا
- لا توقف الرسم على الخادم للموقع كله.
- لا تخفِ التحذير بـ suppressHydrationWarning في كل مكان.