discord.py OAuth2实现用户入服遇权限缺失错误（50013）求助

错误原因排查与解决办法 #

1. OAuth2授权缺失guilds.join权限范围 #

这是触发该错误的核心原因之一：你的OAuth2授权流程必须请求guilds.join scope，否则获取到的access_token没有权限允许Bot将用户加入服务器。

• 解决：生成用户授权URL时，确保scope参数包含guilds.join（例如：scope=identify+guilds.join）。只有用户授权了该范围，返回的access_token才能用于调用添加成员的API。

2. Bot未加入目标服务器 #

你的Bot必须已经存在于目标服务器（ID：622176715183226910）中，否则无法执行添加成员的操作。

• 解决：生成Bot的邀请链接，邀请时勾选「创建邀请」权限，将Bot加入目标服务器。邀请链接的权限参数需包含0x00000010（对应CREATE_INSTANT_INVITE权限）。

3. Bot在目标服务器的权限不足 #

即使你配置了权限，仍可能存在以下问题：

• Bot未开启CREATE_INSTANT_INVITE权限：添加成员到服务器必须依赖该核心权限。
• Bot角色层级低于用户现有角色（若用户已在服务器内）：如果用户已在服务器中，Bot的角色层级必须高于用户角色才能执行操作（新用户加入场景可忽略，但仍建议检查）。
• 解决：在目标服务器的角色设置中，确保Bot角色拥有「创建邀请」权限，且角色位置尽量靠上（高于普通用户角色）。

4. 代码中的潜在问题 #

• 重复定义on_ready事件：代码里写了两个on_ready函数，会导致其中一个被覆盖，影响Bot初始化逻辑，保留一个即可。
• 硬编码授权code：你直接使用固定字符串abcdefghijklmnopqrstuvwxyz作为授权code，实际应该使用用户授权后跳转返回的动态code，否则获取的access_token无效或权限不足。
• 解决：移除重复的on_ready事件，确保使用用户实际授权返回的code交换access_token。

修正后的关键代码示例 #

生成包含正确权限范围的授权URL（需在前端/网页中提供给用户授权）：

# 生成授权URL
AUTH_URL = f"{API_ENDPOINT}/oauth2/authorize?client_id={CLIENT_ID}&redirect_uri={REDIRECT_URI}&response_type=code&scope=identify+guilds.join"

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