discord.py のよくあるエラー一覧と解決方法【まとめ】
Bot を動かしていると、英語のエラーメッセージが出て止まってしまうことがあります。このページでは、discord.py で特によく見るエラーを、意味と直し方つきで一覧にまとめました。コンソールに出たエラーの一番下の行を、このページの見出しと見比べてみてください。
起動・ログインのエラー
discord.errors.LoginFailure: Improper token has been passed.
意味:トークンが間違っています。
直し方:Developer Portal の「Bot」→「Reset Token」で再発行し、コピーし直します。前後の空白や " が入っていないかも確認しましょう。Client Secret や Application ID と間違えるのもよくあるミスです。
discord.errors.PrivilegedIntentsRequired
意味:コードで有効にした特権インテントが、Developer Portal でオンになっていません。
直し方:「Bot」ページで該当のインテントをオンにします。詳しくは「特権インテントとは?」を見てください。
ModuleNotFoundError: No module named 'discord'
意味:discord.py がインストールされていません。
直し方:pip install -U discord.py を実行します。サーバーで動かす場合は requirements.txt に discord.py と書きます。詳しくは「requirements.txt の書き方」へ。
TypeError: __init__() missing 1 required keyword-only argument: 'intents'
意味:discord.py 2.x では intents の指定が必須です。
直し方:
intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)
KeyError: 'DISCORD_TOKEN'
意味:環境変数(または .env)にトークンが設定されていません。
直し方:.env ファイルの置き場所と名前、load_dotenv() を呼んでいるかを確認します。
コマンド・動作のエラー
message.content が空になる
意味:Message Content Intent がオフです。
直し方:「Message Content Intent の設定方法」を見てください。
スラッシュコマンドが表示されない
直し方:await bot.tree.sync() を呼んでいるか、招待 URL に applications.commands が含まれているかを確認します。Discord アプリを再起動(Ctrl+R)すると表示されることもあります。
「インタラクションに失敗しました」/ 404 Unknown interaction
意味:3秒以内に返事をしていません。
直し方:重い処理の前に await interaction.response.defer() を入れ、最後に await interaction.followup.send(...) で返します。
InteractionResponded: This interaction has already been responded to before
意味:1つのインタラクションに2回 response で返事をしています。
直し方:2回目以降は interaction.followup.send() を使います。
403 Forbidden (error code: 50013): Missing Permissions
意味:Bot にその操作をする権限がありません。
直し方:Bot のロールの権限と、ロールの並び順(Bot のロールが操作したいロールより上か)を確認します。「招待方法と権限の選び方」も参考にしてください。
403 Forbidden (error code: 50001): Missing Access
意味:Bot がそのチャンネルを見られません。
直し方:チャンネルの権限設定で、Bot のロールに「チャンネルを見る」を許可します。
AttributeError: 'NoneType' object has no attribute 'send'
意味:bot.get_channel() が None を返しています。
直し方:ID が正しいか(数字で、文字列にしていないか)、Bot がそのサーバーに入っているか、ログインが終わる前に呼んでいないかを確認します。
RuntimeWarning: coroutine '...' was never awaited
意味:await が必要な関数を await なしで呼んでいます。
直し方:channel.send(...) → await channel.send(...) のように直します。
止まる・落ちるエラー
429 Too Many Requests
送りすぎによる制限です。「レート制限の原因と対処法」を見てください。
しばらくすると勝手に止まっている
パソコンのスリープや、無料サービスの停止が原因のことが多いです。「Bot がすぐ止まる原因と対策」で確認できます。
エラーの読み方のコツ
- エラーは一番下の行が本体。その少し上に、自分のファイルの何行目で起きたかが書かれています(
File "main.py", line 25)。 - エラー文をそのまま検索すると、同じ問題の解決方法が見つかりやすいです。ただしトークンは絶対に貼らないでください。
- discord.py 1.x 向けの古い記事のコードは、2.x ではそのまま動かないことが多いです。
Discord Bot を、月 ¥180 で24時間。
支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →