Errori bot Discord: token non valido, intent, Lavalink

​

”LoginFailure: Improper token has been passed” / TokenInvalid

• discord.py: discord.errors.LoginFailure: Improper token has been passed.
• discord.js v14: Error [TokenInvalid]: An invalid token was provided.
• discord.js meno recente: Error [TOKEN_INVALID]: An invalid token was provided.
• altre librerie: un HTTP 401 Unauthorized al login.

• 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, oppure la variabile non è impostata su Square Cloud.

1. Vai al Developer Portal → la tua applicazione → Bot → Reset Token.
2. Aggiorna il token nelle variabili d’ambiente dell’applicazione (nella dashboard Impostazioni → Variabili d’ambiente, oppure con squarecloud app env set). 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, così carica il nuovo valore.

​

”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.
• Il bot è stato arrestato per aver superato la RAM o la CPU, oppure per aver inondato l’API di Discord di richieste. In questo caso i log mostrano una riga [SQUARE-SHIELD] e ricevi un’email: vedi la tabella degli stati.

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. Aggiungi AUTORESTART=true al tuo squarecloud.app perché Square Cloud riavvii il bot dopo un crash. È disattivato per impostazione predefinita e riavvia solo nei casi elencati in AUTORESTART. Mantiene il bot vivo attraverso errori transitori, ma non risolve mai un token non valido, 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. Un bot che continua a inondare Discord di richieste viene arrestato con ABUSE_REQUESTS.

​

Guide correlate

• Tutorial sull’hosting dei bot Discord: configura e pubblica un bot da zero.
• Variabili d’ambiente: conserva il token fuori dal codice.
• L’app non si avvia: errori di upload, moduli mancanti e altri errori di avvio.

​

Contattaci