discord.py机器人on_member_join事件报错：缺失members与member必填参数

这个报错的核心是当前实际生效的on_member_join事件处理函数的参数签名，和discord客户端触发事件时传入的参数不匹配。
正常discord.py及衍生分支（pycord、nextcord等）中，on_member_join事件触发时只会向处理函数传入1个参数：即新加入的member实例。报错提示函数缺少2个必填参数，说明当前运行的并非你贴出的只接收1个参数的函数版本，该函数实际需要至少3个位置参数。

常见诱因及对应修复方案 #

• 存在重复定义的on_member_join函数
  discord.py默认会使用代码中最后定义的同名事件函数，如果你在文件其他位置（如类内部、代码靠前的区块）还定义了另一个参数更多的on_member_join，且同样添加了@bot.event装饰器，就会覆盖你预期的函数。
  排查方法：全局搜索代码中所有on_member_join的定义，删除多余的重复定义；也可以在你写的on_member_join函数内临时加一行print("生效的是这个函数")，如果事件触发时没有输出，即可确认是重复定义的问题。
• 误在Cog类中使用错误的事件装饰器
  如果你把on_member_join写在commands.Cog的子类中，却错误使用了@bot.event而非Cog专属的@commands.Cog.listener()装饰器，会导致函数第一个参数被识别为类实例self，凭空多出一个必填参数。如果此时你还额外多写了其他参数（如误加了guild、members参数），就会出现缺2个参数的报错。
  修复方案：如果在Cog中使用该事件，需替换为对应装饰器，函数签名仅保留self和member两个参数：

class MyCog(commands.Cog):
    @commands.Cog.listener()
    async def on_member_join(self, member):
        await member.send('test')

如果事件函数写在类外部，直接使用@bot.event装饰器即可，确保函数仅接收单个member参数。

• 虚拟环境存在冲突的discord相关库
  若同时安装了多个discord相关的Python库（如discord.py和pycord），可能出现导入冲突，导致事件签名异常。
  修复方案：卸载所有已安装的discord相关库，重新安装你需要的版本即可。

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