如何用discord.py检测指定名称+标签的用户存在并显示头像？

核心方法说明 #

discord.py v2.0及以上版本提供了fetch_user_by_username_and_discriminator方法，专门用于通过用户名+标签获取用户对象，不管该用户是否在你的Bot所在服务器中，正好匹配你的需求。

实现步骤 #

1. 先确保discord.py版本达标，执行升级命令：

pip install -U discord.py

2. 编写枚举检查的代码逻辑：

• 循环遍历0到9999的所有标签值，格式化为四位数字（比如12变成0012）
• 调用方法尝试获取用户，捕获NotFound异常跳过不存在的组合
• 成功获取用户后，直接读取头像URL或保存头像

示例代码 #

import discord
import asyncio
from discord.ext import commands

# 配置Bot基础权限
intents = discord.Intents.default()
bot = commands.Bot(command_prefix='!', intents=intents)

# 替换成你要找的目标用户名
TARGET_NAME = "你的目标用户名"

@bot.event
async def on_ready():
    print(f"Bot已登录：{bot.user}")
    for disc_num in range(10000):
        # 格式化标签为四位字符串
        discriminator = f"{disc_num:04d}"
        try:
            # 尝试获取对应用户
            user = await bot.fetch_user_by_username_and_discriminator(TARGET_NAME, discriminator)
            # 输出匹配到的用户信息
            print(f"\n找到用户：{user.name}#{user.discriminator}")
            print(f"用户ID：{user.id}")
            print(f"头像链接：{user.display_avatar.url}")
            # 可选：将头像保存到本地
            # await user.display_avatar.save(f"{user.name}_{discriminator}.png")
        except discord.NotFound:
            # 该标签无匹配用户，直接跳过
            continue
        except discord.RateLimited:
            # 触发API频率限制，暂停1秒再继续
            print("触发频率限制，暂停1秒")
            await asyncio.sleep(1)
        except Exception as e:
            print(f"检查#{discriminator}时出错：{str(e)}")
            await asyncio.sleep(0.5)

# 替换成你的Bot令牌
bot.run("你的Bot令牌")

注意事项 #

• 必须使用Bot令牌：绝对不能用个人用户令牌，Discord会封禁违规使用用户令牌的账号。
• 频率限制：Discord API有请求次数上限，遇到RateLimited异常时一定要加延迟，避免Bot被限流甚至封禁。
• 头像获取：user.display_avatar.url会返回用户当前的头像链接（支持动态头像的话是GIF格式），调用save方法可直接将头像保存到本地。

内容的提问来源于stack exchange，提问作者Boykisser