Discord-Bot-Fehler: ungültiger Token, Intents, 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.
• ältere discord.js-Versionen: Error [TOKEN_INVALID]: An invalid token was provided.
• andere Bibliotheken: ein HTTP-401 Unauthorized bei der Anmeldung.

• Das Token wurde im Discord Developer Portal neu generiert oder widerrufen. Ein neu generiertes Token macht das alte überall dort, wo es verwendet wird, sofort ungültig.
• Der Token-String enthält versehentlich zusätzliche Leerzeichen oder Anführungszeichen.
• Der Code liest die falsche Umgebungsvariable, oder die Variable ist auf Square Cloud nicht gesetzt.

1. Gehe zum Developer Portal → deine Anwendung → Bot → Reset Token.
2. Aktualisiere das Token in den Umgebungsvariablen der Anwendung (im Dashboard unter Einstellungen → Umgebungsvariablen oder mit squarecloud app env set). Committe das Token nie in einer Datei, die in der ZIP-Datei hochgeladen wird.
3. Prüfe, dass keine überflüssigen Leerzeichen oder Anführungszeichen um den Wert stehen.
4. Aktualisiere die Bibliothek (discord.js@latest oder pip install -U discord.py).
5. Starte die Anwendung neu, damit sie den neuen Wert lädt.

​

”Used disallowed intents” / Message Content Intent

1. Discord Developer Portal → deine Anwendung → Bot → Privileged Gateway Intents → aktiviere Message Content Intent.
2. Deklariere ihn auch im 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. Starte die Anwendung neu.

​

Lavalink-Verbindung mit Code 1006 geschlossen

1. Gleiche die Version des Lavalink-Client-Wrappers deines Bots mit der Hauptversion des Lavalink-Servers ab (v3-Client mit v3-Server, v4-Client mit v4-Server).
2. Auf Square Cloud bindet der Lavalink-Server selbst an Port 80, aber dein Bot muss sich über den Edge auf Port 443 mit secure: true verbinden.
3. Starte sowohl die Lavalink-Anwendung als auch die Bot-Anwendung neu, nachdem du die Versionsinkompatibilität behoben hast.

​

Bot geht offline, nachdem er lokal funktioniert hat

• Eine instabile Verbindung auf Gateway-Ebene ohne Reconnect-Handling.
• Widersprüchliche oder inkompatible Abhängigkeitsversionen zwischen dem, was du lokal getestet hast, und dem, was in deiner Abhängigkeitsdatei steht.
• Der Bot wurde gestoppt, weil er seinen RAM oder seine CPU überschritten oder die Discord-API überflutet hat. In diesem Fall zeigen die Logs eine Zeile [SQUARE-SHIELD], und du erhältst eine E-Mail: siehe die Statustabelle.

1. Prüfe zuerst die Logs der Anwendung im Dashboard, sie zeigen den tatsächlichen Absturzgrund.
2. Füge Error-Handler hinzu, damit ein vorübergehender Fehler den Prozess nicht abstürzen lässt: process.on("unhandledRejection", ...) und client.on("error", ...) in discord.js, entsprechendes Handling in discord.py.
3. Füge AUTORESTART=true zu deiner squarecloud.app hinzu, damit Square Cloud den Bot nach einem Absturz neu startet. Standardmäßig ist das ausgeschaltet, und der Neustart erfolgt nur in den Fällen, die unter AUTORESTART aufgeführt sind. Das hält den Bot bei vorübergehenden Fehlern am Leben, behebt aber nie ein ungültiges Token, einen Syntaxfehler oder eine fehlende Abhängigkeit: Diese brauchen weiterhin eine Korrektur im Code.
4. Achte auf Discord-API-Rate-Limits (429): das globale Limit liegt bei etwa 50 Anfragen/Sekunde pro Bot-Token, mit engeren Limits pro Route (Kanal erstellen/bearbeiten erlaubt etwa 2 Änderungen pro 10 Minuten pro Kanal). Cache aggressiv, verwende eine asynchrone Queue, die die Header X-RateLimit-Remaining/X-RateLimit-Reset-After respektiert, und nutze Webhooks für Massenversand. Ein Bot, der Discord weiter überflutet, wird mit ABUSE_REQUESTS gestoppt.

​

Weiterführende Anleitungen

• Tutorial zum Hosten von Discord-Bots: einen Bot von Grund auf einrichten und deployen.
• Umgebungsvariablen: das Token außerhalb deines Codes speichern.
• App startet nicht: Upload-Fehler, fehlende Module und andere Startprobleme.

​

Kontaktiere uns