اقرأ الكونسول وافهم ما حدث

يوضح كل سطر في الكونسول متى طُبع، ومن طبعه، وما يقوله. ابحث عن سطرك هنا، ثم اعرف ما يلزم فعله.

أين تجد السجل

يعرض تبويب الكونسول كل سطر لحظة طباعته، من بوتك ومنّا. وتعرض بطاقة آخر السجل في نظرة عامة آخر الأسطر التي طبعها بوتك، ويحفظ تبويب النشرات سجل كل نشر: افتح القائمة في آخر صفه واضغط افتح السجل.

اقرأ السطر

1. الوقت الذي طُبع فيه السطر.
2. من طبعه: BOT لما يطبعه بوتك، ومعه سطور serverk: التي نطبعها، و BRIDGE للبرنامج الذي يشغّل بوتك ويراقبه، و API لمنصة سيرفرك نفسها، مثل بدء نشر جديد.
3. السطر نفسه، ويظهر باللون الأحمر إذا كان خطأ.

سطور serverk

كل سطر يبدأ بـ serverk: صادر منا وليس من بوتك، ويوضح ما نفّذناه قبل أن يبدأ:

• deploying ...: بدأ نشر جديد.
• fetching ... at ... أو unpacking snapshot ...: نسحب الـ commit من الريبو، أو نفك الكود الذي رفعته.
• installing dependencies ...: نثبّت المكتبات.
• dependencies are up to date: لم يتغيّر شيء، فلم نعد التثبيت.
• deployment ... ready at ...: نجح النشر.
• web address ... on port ...: عنوان الويب لبوتك، والمنفذ الذي يلزم أن يستمع عليه، ما دام عنوان الويب مفعّلًا.
• port 1 ... و port 2 ...: رقم كل منفذ مفعّل، ومعه العنوان الذي يتصل به الآخرون إذا كان عنوان الويب مفعّلًا.
• start command: ...: الأمر الذي نشغّل به بوتك.
• bot process starting: بدأ بوتك، وكل سطر بعده يطبعه بوتك نفسه.

عندما يتعطّل بوتك

تظهر الأخطاء باللون الأحمر. اقرأ أول سطر أحمر، لا آخر سطر:

TypeError: Cannot read properties of undefined (reading 'send')
    at Client.<anonymous> (/home/container/index.js:12:18)

يوضح السطر الأول نوع الخطأ، ويوضح الذي بعده مكانه: الملف index.js، السطر 12.

أشهر الأخطاء

عندما يتوقف بوتك على سبب نعرفه، تذكر صفحة النشر السبب، ويفتح اقرأ الشرح قسمه في شرح «أخطاء بوتك وحلولها».

• deployment ... failed: sync: ...: تعذّر سحب الـ commit. تأكد من وجود الريبو والفرع، ومن أن تطبيق Serverk على GitHub يصل إلى الريبو.
• deployment ... failed: sync: repository tracks .serverk: في الريبو مجلد .serverk، وهذا الاسم محجوز لمنصة سيرفرك. احذف المجلد من الريبو وانشر من جديد.
• deployment ... failed: install: ...: فشل تثبيت المكتبات، والسطر يوضح السبب. غالبًا يكون package-lock.json غير متوافق مع package.json، فشغّل npm install على جهازك وارفع ملف القفل الجديد.
• deployment ... failed: pre-deploy: ...: فشل أمر ما قبل النشر. اقرأ الأسطر التي طبعها الأمر فوق هذا السطر، ثم انشر من جديد.
• deployment ... failed: start: nothing to start: لم نجد طريقة لتشغيل بوتك. أضف start إلى package.json، أو اضبط أمر التشغيل من إعدادات بوتك.
• TokenInvalid أو 401 Unauthorized: التوكن غير صحيح أو تغيّر. تأكد من اسم المتغير وقيمته، ثم انشر من جديد.
• Used disallowed intents: فعّل الـ intent الذي يطلبه بوتك من صفحة Bot في Developer Portal.
• Cannot find module: المكتبة غير موجودة في package.json. أضفها وارفع معها ملف القفل، ثم انشر من جديد.
• JavaScript heap out of memory: استهلك بوتك الرام كاملة. انتقل إلى باقة أكبر، أو قلّل ما يحتفظ به بوتك في الذاكرة.