Lorixen.
AR

خطأ hydration في Next.js بسبب التاريخ والوقت: كيف تصلحه

باختصار: إذا ظهر في موقعك المبني بـ Next.js خطأ يقول إن محتوى النص لا يطابق ما أرسله الخادم، وكان الخطأ يتعلق بوقت أو تاريخ، مثل «آخر تحديث للمنيو» أو «الطلب خلال ساعتين»، فالسبب غالباً أن الخادم والمتصفح حسبا الوقت بشكل مختلف. توثيق Next.js يذكر استخدام الدوال المعتمدة على الوقت مثل Date() أثناء العرض كأحد الأسباب الشائعة لخطأ hydration. الحل أن يعرض الخادم والمتصفح الشيء نفسه في أول عرض: إما بتثبيت المنطقة الزمنية واللغة في التنسيق، أو بتأجيل الجزء المتغير ليُحسب في المتصفح فقط.

ما معنى hydration ببساطة؟

في مواقع Next.js، الخادم يجهز صفحة HTML جاهزة ويرسلها للزائر بسرعة، ثم يحمّل المتصفح JavaScript ويجعل الصفحة تفاعلية. توثيق Next.js يصف hydration بأنها اللحظة التي يحول فيها React صفحة HTML المجهزة مسبقاً من الخادم إلى تطبيق تفاعلي بربط الأحداث بالعناصر.

لكي تنجح هذه العملية، يجب أن يكون ما يرسمه المتصفح في أول مرة مطابقاً لما أرسله الخادم. إذا اختلف النص، يظهر خطأ عدم التطابق، وقد يعيد React رسم جزء من الصفحة، فيلاحظ الزائر وميضاً أو قفزة، ويلاحظ المطور رسائل حمراء في وحدة التحكم.

لماذا التاريخ والوقت بالذات؟

خذ مثالاً توضيحياً: مطعم في الزرقاء لديه صفحة منيو تعرض «آخر تحديث: الساعة 9:15 مساءً»، وصفحة طلب تعرض «يصل طلبك قبل 10:30». الموقع مستضاف على خادم في أوروبا، والزائر في الأردن.

  • الخادم ينسق الوقت حسب منطقته الزمنية الافتراضية.
  • متصفح الزائر ينسق الوقت نفسه حسب منطقة هاتفه.
  • النتيجة: الخادم كتب ساعة، والمتصفح يريد ساعة أخرى، فيظهر عدم التطابق.

وهناك سبب آخر أبسط: إذا كان الكود يستدعي الوقت الحالي أثناء العرض، فالخادم يحسبه في لحظة، والمتصفح يحسبه بعد ثوانٍ أو دقائق. أي عبارة مثل «منذ دقيقة» قد تتغير بين اللحظتين.

توثيق MDN لـ Intl.DateTimeFormat يوضح أن خيار timeZone يحدد المنطقة الزمنية المستخدمة، ويمكن أن يكون أي اسم منطقة زمنية من قاعدة IANA، وأن القيمة الافتراضية هي المنطقة الزمنية لبيئة التشغيل. هذه النقطة الأخيرة هي أصل المشكلة: بيئة التشغيل على الخادم ليست هاتف الزبون.

الأسباب الأخرى التي يذكرها التوثيق

قبل أن تفترض أن التاريخ هو السبب، اعرف القائمة الكاملة. توثيق Next.js يذكر من الأسباب الشائعة:

  • تداخل وسوم HTML بشكل غير صحيح، مثل فقرة داخل فقرة، أو div داخل فقرة، أو رابط داخل رابط.
  • التحقق من وجود window أثناء العرض.
  • استخدام واجهات المتصفح فقط مثل window أو localStorage أثناء العرض.
  • استخدام دوال معتمدة على الوقت مثل Date() أثناء العرض.
  • إضافات المتصفح التي تعدل HTML.
  • مكتبات CSS-in-JS غير مضبوطة.
  • شبكة توزيع محتوى أو خدمة وسيطة تعدل استجابة HTML، ويذكر التوثيق مثال التصغير التلقائي في Cloudflare.

إذا كان الخطأ يظهر عند زائر واحد فقط، فقد تكون إضافة متصفح عنده هي السبب. أما إذا ظهر عند الجميع وبجانب نص فيه وقت، فالتاريخ هو المشتبه الأول.

الحل الأول: ثبّت المنطقة الزمنية واللغة

إذا كان المقصود أن يرى كل الزبائن وقت المطعم في عمّان، لا وقت هواتفهم، فالحل الأوضح أن يُنسق الوقت دائماً بمنطقة زمنية محددة. حسب MDN، يمكن تمرير اسم المنطقة من قاعدة IANA في خيار timeZone، والمنطقة المستخدمة للأردن في هذه القاعدة هي Asia/Amman. حدد كذلك اللغة نفسها في التنسيق، مثل العربية أو العربية الأردنية، كي لا يعتمد الشكل على لغة الجهاز أو الخادم.

بهذا يحسب الخادم والمتصفح النص نفسه، فيختفي عدم التطابق، ويرى كل الزبائن الموعد بتوقيت المطعم. هذا مناسب لأوقات الدوام ومواعيد الحجز والتوصيل.

الحل الثاني: احسب الجزء المتغير في المتصفح فقط

بعض النصوص يجب أن تعتمد على جهاز الزائر أو على اللحظة الحالية، مثل «منذ 3 دقائق». توثيق Next.js يقترح استخدام useEffect بحيث يعرض الخادم والمتصفح المحتوى نفسه في أول عرض، ثم يحدّث المتصفح الجزء المتغير بعد ذلك. عملياً: يعرض الخادم شيئاً ثابتاً، مثل التاريخ الكامل أو مساحة فارغة، ثم يستبدله المتصفح بالعبارة النسبية بعد التحميل.

ويذكر التوثيق أيضاً إمكانية تعطيل العرض على الخادم لمكونات معينة باستخدام التحميل الديناميكي، وهذا مفيد لمكون صغير يعتمد كلياً على المتصفح، مثل عداد تنازلي لعرض محدود.

الحل الثالث: إسكات التحذير، بحذر

التوثيق يذكر أن بعض المحتوى سيختلف حتماً بين الخادم والمتصفح، مثل الطابع الزمني، ويمكن إسكات تحذير عدم التطابق بإضافة suppressHydrationWarning إلى العنصر. استخدم هذا فقط لعنصر صغير تعرف لماذا يختلف، مثل وقت تحديث الصفحة. لا تستخدمه لإخفاء مشكلة لا تفهمها، لأنك بذلك تخفي الرسالة لا السبب.

خزّن الوقت مرة واحدة ونسّقه عند العرض

جزء كبير من هذه المشاكل يبدأ من قاعدة البيانات، لا من الصفحة. إذا خُزن موعد التوصيل كنص جاهز مثل «10:30 مساءً» دون معرفة منطقته، فلن يعرف أحد لاحقاً هل هو بتوقيت الخادم أم بتوقيت المطعم. الأسلم أن يُخزن الوقت كلحظة زمنية كاملة واضحة، ثم يُنسق عند العرض بالمنطقة واللغة اللتين قررتهما. بهذه الطريقة يمكن للخادم والمتصفح وأي تطبيق آخر، مثل تطبيق السائق أو لوحة المطبخ، عرض الموعد نفسه دون اختلاف. وعندما يتغير مزود الاستضافة أو منطقة الخادم، لا تتغير المواعيد المعروضة للزبائن.

كيف تختار الحل المناسب لكل نص؟

اسأل سؤالاً واحداً عن كل تاريخ أو وقت في الموقع: «من صاحب هذا الوقت؟»

  • وقت المحل أو المطعم: دوام، موعد حجز، وقت توصيل متوقع. نسّقه بمنطقة Asia/Amman ولغة ثابتة.
  • وقت الزائر: «منذ كم دقيقة»، أو تاريخ اليوم عنده. احسبه في المتصفح بعد أول عرض.
  • وقت ثابت لا يتغير: تاريخ نشر مقال. خزّنه كنص منسق أو نسّقه بإعدادات ثابتة.

اكتب هذا القرار في ملاحظات المشروع، كي لا يعود المطور التالي إلى المشكلة نفسها.

اختبار بسيط قبل الإطلاق

اطلب من المطور تجربة الصفحة وجهازه مضبوط على منطقة زمنية مختلفة عن الخادم، ومتابعة وحدة التحكم في المتصفح. إذا اختفت رسالة عدم التطابق، وظهر الوقت الصحيح لزبون في الأردن، فالإصلاح يعمل. وكرر التجربة بعد أي نقل للاستضافة، لأن منطقة الخادم قد تتغير معه.

أسئلة شائعة

شو يعني خطأ hydration بموقع Next.js؟

يعني أن ما رسمه المتصفح في أول مرة لا يطابق صفحة HTML التي أرسلها الخادم، فيعيد React رسم جزء منها.

ليش الخطأ بيطلع عند نص فيه ساعة أو تاريخ؟

لأن الخادم والمتصفح قد يستخدمان منطقة زمنية مختلفة، أو يحسبان الوقت الحالي في لحظتين مختلفتين.

هل أكتب suppressHydrationWarning وخلص؟

فقط لعنصر صغير تعرف لماذا يختلف. هو يسكت التحذير ولا يصلح السبب.

الخطأ بيطلع عند زبون واحد بس، ليش؟

قد تكون إضافة في متصفحه تعدل الصفحة. التوثيق يذكر إضافات المتصفح كأحد الأسباب.

إذا كانت أوقات موقعك تظهر خطأ أو تسبب رسائل حمراء، راسلنا ونراجعها مع فريقك.

المصادر

WhatsAppاحجز مكالمة