You need to enable JavaScript to run this app. 【Discord.py】能否通过用户名+tag(如user#1234)获取user对象或用户ID?
优惠活动
大模型
产品
解决方案
定价
更多

【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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 07:06:03