Errori dei bot Discord su Square Cloud: LoginFailure, Intent non consentiti, Lavalink 1006

​

”LoginFailure: Improper token has been passed” / TOKEN_INVALID

• Il token è stato rigenerato o revocato nel Discord Developer Portal. Generare un nuovo token invalida istantaneamente quello vecchio ovunque venga usato.
• La stringa del token ha spazi o virgolette extra copiati per errore.
• Il codice sta leggendo la variabile d’ambiente sbagliata.

1. Vai al Developer Portal → la tua applicazione → Bot → Reset Token.
2. Aggiorna il token nelle Variabili d’ambiente di questa applicazione nella dashboard di Square Cloud. Non fare mai commit del token in un file che viene caricato nello .zip.
3. Controlla che non ci siano spazi o virgolette estranei intorno al valore.
4. Aggiorna la libreria (discord.js@latest oppure pip install -U discord.py).
5. Riavvia l’applicazione.

​

”Used disallowed intents” / Message Content Intent

1. Discord Developer Portal → la tua applicazione → Bot → Privileged Gateway Intents → abilita Message Content Intent.
2. Dichiaralo anche nel codice:

// 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. Riavvia l’applicazione.

​

Connessione Lavalink chiusa con codice 1006

1. Allinea la versione del wrapper client Lavalink del tuo bot con la versione principale del server Lavalink (client v3 con server v3, client v4 con server v4).
2. Su Square Cloud, il server Lavalink stesso è collegato alla porta 80, ma il tuo bot deve connettersi tramite l’edge sulla porta 443 con secure: true.
3. Riavvia sia l’applicazione Lavalink che l’applicazione del bot dopo aver risolto l’incompatibilità di versione.

​

Il bot va offline dopo aver funzionato in locale

• Una connessione instabile a livello di gateway senza gestione della riconnessione.
• Versioni delle dipendenze in conflitto o incompatibili tra quello che hai testato in locale e quello che è nel tuo file delle dipendenze.
• Trigger di abuso dell’API di Discord (in questo caso l’account riceve un’email di notifica) dovuti a un uso troppo aggressivo dei rate limit.

1. Controlla prima i log dell’applicazione nella dashboard, mostrano il motivo reale del crash.
2. Aggiungi error handler in modo che un errore transitorio non faccia crashare il processo: process.on("unhandledRejection", ...) e client.on("error", ...) in discord.js, gestione equivalente in discord.py.
3. Square Cloud riavvia automaticamente un’app in crash (AUTORESTART nel manifest) quando l’uptime precedente è stato superiore a 60 secondi, lo stato di uscita era 1, e non si è auto-riavviata negli ultimi 60 minuti. Questo mantiene il bot vivo attraverso errori transitori, ma non risolve mai un errore di codice sottostante, un errore di sintassi o una dipendenza mancante, quelli richiedono comunque una correzione nel codice.
4. Fai attenzione ai rate limit dell’API di Discord (429): il limite globale è di circa 50 richieste/secondo per token del bot, con bucket per-route più stretti (creazione/modifica canale consente circa 2 modifiche ogni 10 minuti per canale). Usa la cache in modo aggressivo, usa una coda asincrona che rispetti gli header X-RateLimit-Remaining/X-RateLimit-Reset-After, e usa i webhook per gli invii di massa.

​

Contattaci