Discord ボットのエラー: 無効なトークン、インテント、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: Error [TOKEN_INVALID]: An invalid token was provided.
• その他のライブラリ: ログイン時に HTTP 401 Unauthorized。

• Discord Developer Portal でトークンが再生成または失効しました。新しいトークンを生成すると、それが使われているすべての場所で古いトークンが即座に無効になります。
• トークンの文字列に、誤ってコピーされた余分なスペースや引用符が含まれています。
• コードが誤った環境変数を読み込んでいるか、Square Cloud にその変数が設定されていません。

1. Developer Portal → アプリケーション → Bot → Reset Token に移動します。
2. アプリケーションの環境変数でトークンを更新します（ダッシュボードの 設定 → 環境変数、または squarecloud app env set）。トークンを zip にアップロードされるファイルにコミットしないでください。
3. 値の前後に余分なスペースや引用符がないか再確認します。
4. ライブラリを更新します（discord.js@latest または pip install -U discord.py）。
5. 新しい値を読み込ませるために、アプリケーションを再起動します。

​

“Used disallowed intents” / Message Content Intent

1. Discord Developer Portal → アプリケーション → Bot → Privileged Gateway Intents → Message Content Intent を有効化します。
2. コード側でも宣言します。

// 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. アプリケーションを再起動します。

​

Lavalink connection closed with code 1006

1. ボットの Lavalink クライアントラッパーのバージョンを Lavalink サーバーのメジャーバージョンに合わせます（v3 クライアントには v3 サーバー、v4 クライアントには v4 サーバー）。
2. Square Cloud 上では、Lavalink サーバー自体はポート 80 をバインドしますが、ボットはエッジを通してポート 443 に secure: true で接続する必要があります。
3. バージョンの不一致を修正した後、Lavalink アプリケーションとボットアプリケーションの両方を再起動します。

​

ローカルでは動くのに、デプロイ後ボットがオフラインになる

• ゲートウェイレベルでの接続が不安定で、再接続処理がない。
• ローカルでテストした依存関係のバージョンと、依存関係ファイルに記載されているバージョンが競合または非互換になっている。
• RAM や CPU の超過、または Discord API への過剰なリクエストによって、ボットが停止された。この場合、ログに [SQUARE-SHIELD] の行が表示され、メールが届きます。ステータスの表を参照してください。

1. まずダッシュボードでアプリケーションのログを確認してください。実際のクラッシュ原因が示されます。
2. 一時的なエラーでプロセスがクラッシュしないよう、エラーハンドラを追加します。discord.js では process.on("unhandledRejection", ...) と client.on("error", ...)、discord.py では同等の処理を行います。
3. squarecloud.app に AUTORESTART=true を追加して、クラッシュ後に Square Cloud がボットを再起動するようにします。デフォルトでは無効で、再起動されるのは AUTORESTART に記載された条件のときだけです。一時的なエラーの間もボットを稼働させ続けられますが、無効なトークン、構文エラー、依存関係の欠落が直るわけではないため、それらはコード側での修正が必要です。
4. Discord API のレート制限（429）に注意してください。グローバル制限はボットトークンあたり概ね 50 リクエスト/秒で、ルートごとにさらに厳しい制限があります（チャンネルの作成/編集はチャンネルあたり 10 分でおよそ 2 回まで）。積極的にキャッシュし、X-RateLimit-Remaining/X-RateLimit-Reset-After ヘッダーを尊重する非同期キューを使い、大量送信には Webhook を使用してください。Discord へのリクエストを送り続けるボットは ABUSE_REQUESTS で停止されます。

​

関連ガイド

• Discord ボットホスティングのチュートリアル: ボットをゼロからセットアップしてデプロイします。
• 環境変数: トークンをコードの外に保存します。
• アプリが起動しない: アップロードのエラー、モジュールの不足、その他の起動時の失敗。

​

お問い合わせ