Square Cloud での Discord ボットのエラー: LoginFailure、禁止されたインテント、Lavalink 1006

​

“LoginFailure: Improper token has been passed” / TOKEN_INVALID

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

1. Developer Portal → アプリケーション → Bot → Reset Token に移動します。
2. Square Cloud ダッシュボードのこのアプリケーションの環境変数でトークンを更新します。トークンを .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 アプリケーションとボットアプリケーションの両方を再起動します。

​

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

• ゲートウェイレベルでの接続が不安定で、再接続処理がない。
• ローカルでテストした依存関係のバージョンと、依存関係ファイルに記載されているバージョンが競合または非互換になっている。
• レート制限への過度なアクセスによる Discord API の悪用トリガー（この場合、アカウントに通知メールが届きます）。

1. まずダッシュボードでアプリケーションのログを確認してください。実際のクラッシュ原因が示されます。
2. 一時的なエラーでプロセスがクラッシュしないよう、エラーハンドラを追加します。discord.js では process.on("unhandledRejection", ...) と client.on("error", ...)、discord.py では同等の処理を行います。
3. Square Cloud は、直前の稼働時間が 60 秒を超えていて、終了ステータスが 1 であり、過去 60 分以内に自動再起動していない場合に、クラッシュしたアプリを自動再起動します（マニフェストの AUTORESTART）。これにより一時的なエラーを乗り越えてボットを稼働させ続けられますが、根本的なコードのエラー、構文エラー、依存関係の欠落は修正されないため、コード側での修正が必要です。
4. Discord API のレート制限（429）に注意してください。グローバル制限はボットトークンあたり概ね 50 リクエスト/秒で、ルートごとにさらに厳しい制限があります（チャンネルの作成/編集はチャンネルあたり 10 分でおよそ 2 回まで）。積極的にキャッシュし、X-RateLimit-Remaining/X-RateLimit-Reset-After ヘッダーを尊重する非同期キューを使い、大量送信には Webhook を使用してください。

​

お問い合わせ