ホーム › 使い方ガイド › Discord Bot のレート制限(429 Too Many Requests)の原因と対処法
GUIDE

Discord Bot のレート制限(429 Too Many Requests)の原因と対処法

Bot のログに We are being rate limited や 429 Too Many Requests と出たら、Discord から「短時間にリクエストを送りすぎ」と制限されています。軽いものなら自動で待って再開されますが、繰り返すと Bot が一時的に Discord に接続できなくなることもあります。このページでは、レート制限の仕組みと、よくある原因、対処法を説明します。

レート制限とは

Discord は、サーバーへの負担を防ぐために、Bot が一定時間内に送れるリクエスト(メッセージ送信・ロール変更・チャンネル作成など)の回数に上限を設けています。上限を超えると、しばらくの間リクエストが拒否されます。

種類内容
操作ごとの制限「同じチャンネルへのメッセージ送信」など、操作の種類ごとの上限
全体の制限Bot 全体で1秒あたりに送れるリクエストの上限
不正なリクエストの制限エラー(401・403・429 など)を短時間に大量に出すと、IP ごと一時的に締め出される
discord.py は、ほとんどのレート制限を自動で待ってから再送してくれます。ログに出る Retrying in 3.5 seconds のような表示は、ライブラリが正しく待っている状態です。問題なのは、それが頻繁に出続ける場合です。

よくある原因

1. ループで連続して送っている

# よくない例:一気に100件送る
for user in users:
    await user.send("お知らせです")

大量の DM・メッセージ・ロール変更を一気に行うと、すぐに制限にかかります。

2. 定期処理の間隔が短すぎる

数秒ごとにチャンネル名を変える、メッセージを編集する、といった処理は制限にかかりやすい代表例です。特にチャンネル名の変更は10分に2回までと厳しく制限されています。

3. エラーを出し続けている

権限がない操作を繰り返したり、存在しないメッセージを何度も取得しようとしたりすると、エラーが積み重なって、まとめて締め出されることがあります。

4. 何度も再起動・再ログインしている

Bot がエラーで落ちて、すぐに再起動を繰り返すと、ログインの回数が増えて制限にかかることがあります。

対処法

処理の間に待ち時間を入れる

import asyncio

for user in users:
    try:
        await user.send("お知らせです")
    except discord.Forbidden:
        pass
    await asyncio.sleep(1.5)  # 1件ごとに少し待つ

まとめて送る

1件ずつ送る代わりに、1つのメッセージや Embed にまとめる、メンションをまとめるなど、リクエストの回数自体を減らします。

定期処理の間隔を長くする

from discord.ext import tasks

@tasks.loop(minutes=10)  # 数秒ごとではなく、数分〜十数分ごとに
async def update_status():
    ...

エラーを放置しない

権限エラーや NotFound が出ている処理は、原因を直すか、同じ操作を繰り返さないようにします。

Bot がログインできなくなったときは

ログに 429 とともに長い待ち時間が表示され、Bot が接続できない状態が続く場合は、締め出しが解けるまで(多くは数十分〜1時間程度)Bot を止めて待つのが一番です。その間に、原因になった処理を直しておきましょう。止めずに再起動を繰り返すと、締め出しが長引きます。

同じ IP アドレスを多くの Bot で共有している環境では、ほかの Bot の影響で制限を受けることもあります。StellaHost では、「起動設定」で Bot ごとにプロキシを設定することもできます。

まとめ

  • 429 は「送りすぎ」。discord.py は基本的に自動で待ってくれる
  • ループの連続送信・短すぎる定期処理・エラーの繰り返しが主な原因
  • asyncio.sleep() で間隔をあけ、リクエストの回数自体を減らす

Discord Bot を、月 ¥180 で24時間。

支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →

ほかのガイド

discord.py のよくあるエラー一覧と解決方法【まとめ】LoginFailure・PrivilegedIntentsRequired・ModuleNotFoundError・Missing Permissions・インタラクションに失敗しました など、discord.py でよく出るエラーの意味と直し方を一覧にまとめました。読む → 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 のサンプルコード付きで解説します。読む →