Erreurs des bots Discord sur Square Cloud : LoginFailure, Intents non autorisés, Lavalink 1006

​

« LoginFailure: Improper token has been passed » / TOKEN_INVALID

• Le token a été régénéré ou révoqué dans le Developer Portal de Discord. Générer un nouveau token invalide instantanément l’ancien partout où il est utilisé.
• La chaîne du token a des espaces ou des guillemets copiés par accident.
• Le code lit la mauvaise variable d’environnement.

1. Allez sur le Developer Portal → votre application → Bot → Reset Token.
2. Mettez à jour le token dans les Variables d’environnement de cette application dans le tableau de bord Square Cloud. Ne commitez jamais le token dans un fichier envoyé dans le .zip.
3. Vérifiez qu’il n’y a pas d’espaces ou de guillemets superflus autour de la valeur.
4. Mettez à jour la bibliothèque (discord.js@latest ou pip install -U discord.py).
5. Redémarrez l’application.

​

« Used disallowed intents » / Message Content Intent

1. Developer Portal Discord → votre application → Bot → Privileged Gateway Intents → activez Message Content Intent.
2. Déclarez-le également dans le code :

// discord.js
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

# discord.py
intents = discord.Intents.default()
intents.message_content = True
client = commands.Bot(command_prefix="!", intents=intents)

3. Redémarrez l’application.

​

Connexion Lavalink fermée avec le code 1006

1. Alignez la version du wrapper client Lavalink de votre bot avec la version majeure du serveur Lavalink (client v3 avec serveur v3, client v4 avec serveur v4).
2. Sur Square Cloud, le serveur Lavalink lui-même se lie au port 80, mais votre bot doit s’y connecter via la périphérie sur le port 443 avec secure: true.
3. Redémarrez à la fois l’application Lavalink et l’application du bot après avoir corrigé l’incompatibilité de version.

​

Le bot passe hors ligne après avoir fonctionné en local

• Une connexion instable au niveau de la gateway sans gestion de reconnexion.
• Des versions de dépendances conflictuelles ou incompatibles entre ce que vous avez testé en local et ce qui est dans votre fichier de dépendances.
• Des déclencheurs d’abus de l’API Discord (un compte reçoit un e-mail de notification dans ce cas) dus à des limites de débit dépassées de façon trop agressive.

1. Vérifiez d’abord les logs de l’application dans le tableau de bord, ils montrent la véritable raison du crash.
2. Ajoutez des gestionnaires d’erreurs pour qu’une erreur transitoire ne fasse pas planter le processus : process.on("unhandledRejection", ...) et client.on("error", ...) dans discord.js, gestion équivalente dans discord.py.
3. Square Cloud redémarre automatiquement une application plantée (AUTORESTART dans le manifeste) quand la durée de fonctionnement précédente dépassait 60 secondes, que le statut de sortie était 1, et qu’elle ne s’est pas déjà redémarrée automatiquement dans les 60 dernières minutes. Cela maintient le bot en vie à travers les erreurs transitoires, mais ne corrige jamais une erreur de code sous-jacente, une erreur de syntaxe ou une dépendance manquante, celles-ci nécessitent toujours une correction dans le code.
4. Surveillez les limites de débit de l’API Discord (429) : la limite globale est d’environ 50 requêtes/seconde par token de bot, avec des buckets par route plus stricts (création/modification de salon autorise environ 2 changements par 10 minutes par salon). Mettez en cache de façon agressive, utilisez une file asynchrone qui respecte les en-têtes X-RateLimit-Remaining/X-RateLimit-Reset-After, et utilisez des webhooks pour les envois en masse.

​

Contactez-nous