Discord Botがオフラインのままの原因と確認チェックリスト

Botのプロセスが起動していても、Discord Gatewayへログインできなければオフライン表示になります。管理画面の稼働状態とDiscord上の状態を分けて確認します。

プロセスの状態

管理パネルでは起動中でも、アプリがログイン失敗を繰り返していることがあります。最新ログでプロセス稼働、Discord接続完了、切断理由を確認します。

• Botのコンソールログを開く
• readyや接続完了の記録があるか確認する
• プロセスが再起動を繰り返していないか見る

TokenとApplication

別のApplicationのTokenを設定していると、意図したBotとして表示されません。Tokenの正しい保管場所とBotユーザー、Application IDを確認します。

1. Discord Developer Portalで対象アプリを選ぶ
2. Bot Tokenを環境変数へ設定する
3. Tokenをログやソースコードへ表示しない

Gateway接続とIntents

接続後に特権Intent不足やライブラリの互換性エラーで切断されることがあります。使用する機能に必要なIntentsだけをコードとPortalで有効にします。

• 起動ログにdisallowed intentsがないか見る
• 必要なGateway Intentを両方の設定で有効にする
• 古いDiscordライブラリを更新する

招待先と権限

Botがオンラインでも、サーバーに参加していなければそのサーバーでは見えません。OAuth2の招待URL、対象ギルド、必要権限を確認します。

• Botが対象サーバーのメンバーか確認する
• 必要な最小限の権限を招待時に付与する
• Botの表示ロールとチャンネル権限を確認する