本文详解如何在 discord.py 中安全轮换 bot 活动状态（presence），规避因 `change_presence` 调用过于频繁导致的 websocket 速率限制警告（429 rate limited），重点修正 `asyncio.sleep` 同步误用、补充错误重试机制，并提供健壮、可长期运行的轮播方案。
在 Discord.py 中，通过 bot.change_presence() 动态更新 Bot 的在线状态（如“正在观看…”）是一种常见需求。但许多开发者会遇到如下警告：
WARNING discord.gateway WebSocket in shard ID None is ratelimited, waiting 57.3 seconds
该警告表明：你的 Bot 已被 Discord 网关限流——并非因为 5 分钟间隔太短，而是因为代码中误用了 asyncio.sleep() 的同步形式，导致循环未真正暂停，从而在极短时间内重复发起请求，瞬间触达速率上限（Discord 对 /users/@me/settings 类操作有严格限频，通常为 5 次/5 分钟）。
? 根本问题定位
原始代码中这一行是致命错误：
asyncio.sleep(300) # ❌ 错误！这是协程对象，未 await，不产生实际延迟
它仅创建了一个 asyncio.sleep 协程对象，却未 await 执行，因此 while True 循环几乎零延迟地反复调用 change_presence()，等效于“疯狂刷请求”，远超 Discord 的容忍阈值。
✅ 正确写法必须是：
await asyncio.sleep(300) # ✅ 真正挂起协程，让出控制权
✅ 推荐实现：带错误恢复的稳健轮播
以下是生产环境推荐的完整方案，已整合异常捕获与自动退避：
import asyncio
import random
import discord
from discord.ext import commands
actaray = ["PcktWtchr's Videos", "Cams", "and Listening Always", "or Listening or Both"]
@bot.event
async def on_ready():
print(f'Logged in as {bot.user}')
# 使用后台任务（推荐）或 while 循环均可，此处保持简洁
while True:
try:
activity = discord.Activity(
type=discord.ActivityType.watching,
name=random.choice(actaray)
)
await bot.change_presence(activity=activity)
await asyncio.sleep(300) # ✅ 正确 await，精确 5 分钟间隔
except discord.HTTPException as e:
if e.status == 429: # 遇到限流
retry_after = float(e.response.headers.get("Retry-After", "5"))
print(f"Rate limited! Retrying after {retry_after:.1f}s...")
await asyncio.sleep(retry_
after + 1) # 加 1 秒缓冲，避免边界重试
else:
print(f"HTTP error during presence update: {e}")
await asyncio.sleep(10) # 其他 HTTP 错误，降频重试
except Exception as e:
print(f"Unexpected error in presence loop: {e}")
await asyncio.sleep(60)
# 可选：注册一个独立任务（更优雅，便于管理）
@bot.event
async def on_connect():
if not hasattr(bot, '_presence_task') or bot._presence_task.done():
bot._presence_task = bot.loop.create_task(_presence_rotator())
async def _presence_rotator():
while True:
await _update_random_presence()
await asyncio.sleep(300)
async def _update_random_presence():
try:
await bot.change_presence(
activity=discord.Activity(
type=discord.ActivityType.watching,
name=random.choice(actaray)
)
)
except discord.HTTPException as e:
if e.status == 429:
retry_after = float(e.response.headers.get("Retry-After", "5"))
await asyncio.sleep(retry_after + 1)
⚠️ 关键注意事项
- 不要滥用 change_presence：Discord 明确限制用户级设置类操作（含状态更新）为 5 次/5 分钟/每个用户（Bot 账户即用户）。即使你设为 300s，若前序请求因网络延迟、重试失败而堆积，仍可能触发限流。
- 永远 await 异步函数：asyncio.sleep()、bot.change_presence() 均为协程，必须 await，否则逻辑失效。
- on_error 事件不可靠：Discord.py 的 on_error 并非总能捕获所有 HTTPException（尤其在 on_ready 内部抛出时），因此强烈建议在业务逻辑内直接 try/except，如上例所示。
-
考虑使用 Activity 缓存或去重：若 actaray 列表较短，连续两次选中相同文案虽无害，但影响体验。可加入简单去重逻辑：
last_name = None # 在循环内： name = random.choice([a for a in actaray if a != last_name] or actaray) last_name = name
✅ 总结
解决 Discord.py Presence 限流问题的核心在于：
① 修正 await asyncio.sleep() 用法，确保真实延时；
② 在 change_presence 调用周围包裹 try/except，主动处理 429 并遵循 Retry-After 头；
③ 避免在 on_ready 中裸写无限循环，优先采用任务化（create_task）方式提升可维护性与可观测性。
遵循以上实践，你的 Bot 将稳定、安静地轮播状态，再也不会被网关警告“轰炸”。
