ホーム › 使い方ガイド › discord.py のよくあるエラー一覧と解決方法【まとめ】
GUIDE

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分で、日本のサーバーが自動で用意されます。 プランを見る →

ほかのガイド

requirements.txt の書き方|Bot に必要なライブラリをサーバーに入れる方法サーバーで ModuleNotFoundError が出る原因と、requirements.txt の書き方・自動で作る方法・バージョン指定・import 名とインストール名が違うライブラリの一覧を解説します。読む → discord.py の Cog でコマンドをファイルごとに分ける方法discord.py 2.x の Cog を使って、コマンドやイベントを機能ごとのファイルに分ける方法を解説。setup・load_extension・再読み込み・よくあるエラーまで紹介します。読む → discord.py で定期実行する方法|tasks.loop で毎日・毎時の自動投稿discord.py の tasks.loop で、一定間隔・毎日決まった時刻(日本時間)に処理を実行する方法と、開始・停止、エラー時の対処、よくある失敗を解説します。読む → Discord Bot でデータを保存する方法|SQLite でポイント・レベル機能を作る再起動しても消えないデータを、SQLite(aiosqlite)で Discord Bot に保存する方法を解説。ポイント機能・ランキングのサンプルコードと、サーバーでの注意点を紹介します。読む → discord.py でチケット(お問い合わせ)機能を作る方法ボタンを押すと本人とスタッフだけが見える専用チャンネルが作られる、チケット機能の作り方を discord.py のサンプルコード付きで解説します。読む → discord.py で NG ワード削除・スパム対策・タイムアウトを作る方法discord.py で NG ワードを含むメッセージの自動削除、連投スパムの検知、タイムアウトを作る方法と、Discord 標準の AutoMod との使い分けを解説します。読む →