Discord机器人需获取用户邮箱:配置OAuth email scope后仍无email属性
Discord 机器人无法在用户事件对象中获取email字段的核心原因与解决方法
核心原因
- 当前通过
message事件拿到的msg.member.user,是Discord网关向机器人推送的事件型User对象,从接口设计层面就不会携带email这类用户隐私字段,与配置的scope参数无关,属于接口本身的返回规则。 - 在bot邀请链接中加入的
emailscope在该场景下完全不生效:email是OAuth2用户授权流程的专属权限范围,仅在用户主动走完授权同意流程时才会触发权限校验;bot邀请流程是将机器人账号加入服务器的操作,全程不会触发用户隐私授权环节,自然不会返回邮箱数据。 - 实测打印的用户对象结构完全符合Discord网关接口的返回标准:仅包含公开的用户昵称、ID、头像、身份后缀这类非隐私信息,不会涉及邮箱类敏感字段。
正确获取用户邮箱的流程
- 拆分两类独立的流程逻辑:
- 机器人加入服务器的流程仅保留
botscope和对应权限参数,无需额外添加emailscope。 - 需要获取邮箱的功能,单独给目标用户生成专属的OAuth2授权跳转链接,链接中明确携带
identify、email两个scope,引导用户跳转至Discord授权页,主动勾选同意获取邮箱的权限。
- 机器人加入服务器的流程仅保留
- 完成授权回调处理:
- 用户授权完成后,Discord会带着临时授权code跳转回预设的回调地址
- 服务端使用临时code换取对应的access_token
- 携带access_token调用OAuth2的用户信息接口,此时返回的用户对象才会包含
email、verified这类隐私字段
常见注意事项
- 即便流程正确,也无法100%保证拿到所有用户的邮箱:如果用户账号无绑定邮箱(通过第三方渠道直接注册登录)、或在隐私设置中关闭了第三方应用获取邮箱的权限,接口将返回
null值 - 不要试图通过修改机器人的网关事件监听逻辑获取邮箱:网关接口的返回字段是Discord官方固定的,任何客户端的库封装都无法突破接口规则拿到本就不会下发的隐私字段
内容的提问来源于stack exchange,提问作者xavier wang
相关产品推荐
相关产品推荐

