إصلاح · Node وnpm والبناء

Error occurred prerendering page أثناء next build

ما قد تراه

يفشل البناء عند صفحة واحدة برسالة prerender
يقول window is not defined أو cannot read properties of undefined

السبب الأرجح

أثناء البناء تعمل شيفرة الصفحة على خادم بلا متصفح، وتستخدم أشياء خاصة بالمتصفح (window وlocalStorage) أو بيانات فارغة وقت البناء.

افحص أولاً (نحو دقيقتين)

اقرأ أي صفحة مذكورة في الخطأ.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

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

المشكلة
Error occurred prerendering page أثناء next build

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
أثناء البناء تعمل شيفرة الصفحة على خادم بلا متصفح، وتستخدم أشياء خاصة بالمتصفح (window وlocalStorage) أو بيانات فارغة وقت البناء.

نفّذ هذه الخطوات بهذا الترتيب
1. افتح تلك الصفحة واعثر على السطر الذي يستخدم window أو document أو localStorage أو بيانات قد تكون ناقصة.
2. انقل شيفرة المتصفح إلى effect يعمل بعد تحميل الصفحة أو إلى مكوّن للعميل فقط.
3. تعامل مع البيانات الناقصة بقيمة افتراضية آمنة أو حالة فارغة.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- ينتهي npm run build وتفتح الصفحة.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا تجعل الموقع كله للعميل فقط لتفادي الخطأ.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

افتح تلك الصفحة واعثر على السطر الذي يستخدم window أو document أو localStorage أو بيانات قد تكون ناقصة.
انقل شيفرة المتصفح إلى effect يعمل بعد تحميل الصفحة أو إلى مكوّن للعميل فقط.
تعامل مع البيانات الناقصة بقيمة افتراضية آمنة أو حالة فارغة.

لا تفعل هذا

لا تضع بيانات وهمية لتمرير البناء.
لا تجعل الموقع كله للعميل فقط لتفادي الخطأ.