【Discord.py】能否通过用户名+tag(如user#1234)获取user对象或用户ID?
Discord.py 中通过用户名+Tag获取用户对象的相关说明
当前Discord.py全版本,原生不支持直接传入用户名#1234格式的标识来获取匹配的User对象。
这一限制并非Discord.py框架本身的设计缺陷,根源来自Discord官方API的规则:官方从未开放基于“用户名+4位Discriminator tag”的用户查询接口,所有用于拉取用户对象的API端点,仅支持传入Snowflake格式的用户ID作为查询参数,不存在按用户名、tag字段匹配查询的逻辑。
常见认知误区
很多开发者误以为Client.fetch_user()方法可以支持字符串格式的用户标识,实际上该方法仅接受整数类型的用户ID入参,传入携带tag的字符串会直接触发参数校验错误,无法完成查询。
可落地的替代实现及局限性
如果需要实现类似的查找能力,仅能通过本地遍历匹配的方式实现,且存在严格的使用边界:
- 匹配范围仅能覆盖Bot当前可获取到的所有用户对象,包括本地缓存的User实例、Bot加入的所有服务器的成员列表
- 匹配逻辑需要自行遍历范围内的每个用户,将用户对象的
name字段和discriminator字段拼接成xxx#1234格式,与目标输入字符串做全等比对,才能拿到对应的User对象 - 这种遍历方式存在硬边界:如果目标用户既不在Bot加入的所有服务器的成员列表中,也从未和Bot产生过可被缓存的交互,哪怕输入的用户名和tag完全准确,也无法遍历找到对应的用户对象
- 受Discord用户系统迭代影响,当前老的
用户名#tag格式标识已经不再具备全局唯一性,大量用户已切换为无tag的全局唯一用户名,依赖该格式做本地匹配的逻辑会随系统迭代逐渐失效
内容的提问来源于stack exchange,提问作者Zachicom
相关产品推荐
相关产品推荐

