املأ رمز بوت Discord واجعل كودك يقرأ DISCORD_TOKEN
أخطاء الأذونات
الرسالة
المعنى
الحل
DiscordAPIError[50001]: Missing Access
لا يستطيع البوت رؤية تلك القناة أو ذلك السيرفر
امنح البوت صلاحية الوصول إلى القناة، أو تحقق أنه دُعي بنطاق bot
DiscordAPIError[50013]: Missing Permissions
ينقص البوت إذنًا، أو رتبته منخفضة جدًا
أضف الإذن، وانقل رتبة البوت فوق الرتب التي يديرها
Cannot send messages to this user (50007)
أغلق المستخدم الرسائل المباشرة
عالج ذلك في كودك وأخبره في القناة بدلًا من ذلك
أخطاء التفاعلات (interactions)
الرسالة
المعنى
الحل
Unknown interaction (10062)
تأخر البوت أكثر من 3 ثوانٍ في الرد على أمر slash
ردّ أو أجّل الرد (defer) فورًا، ثم تابع بعد ذلك
Interaction has already been acknowledged
رددت مرتين
ردّ مرة واحدة، ثم استخدم رسالة متابعة
Unknown Message (10008) / Unknown Channel (10003)
حُذفت الرسالة أو القناة
تحقق أنها موجودة قبل استخدامها
حدود المعدل وأخطاء الاتصال
429 Too Many Requests: بوتك يرسل بسرعة كبيرة. تنتظر المكتبة عادةً وتعيد المحاولة بنفسها؛ قلّل الحلقات التي تعدّل رسائل كثيرة أو تضيف تفاعلات كثيرة.
ECONNRESET وConnect Timeout Error وgetaddrinfo: مشكلة شبكة قصيرة بين البوت وDiscord. المكتبة الجيدة تعيد الاتصال. وإذا لم يتعافَ أبدًا، فأعد تشغيل السيرفر.
JavaScript heap out of memory أو توقف السيرفر من تلقاء نفسه: استهلك البوت كل ذاكرته. راجع كم RAM يحتاج بوت Discord؟.
أخطاء الكود
Cannot find module 'x' تعني أن حزمة مفقودة: أضفها إلى package.json (أو إلى خانة حزم npm إضافية). وModuleNotFoundError: No module named 'x' تعني أن سطرًا ناقص في requirements.txt. وللسيرفر الذي يتوقف من تلقاء نفسه راجع لماذا يتوقف بوت Discord باستمرار.