discord.py音乐机器人执行join命令后无法完成语音连接且无报错

你的问题核心是chan.connect()异步调用陷入阻塞：Discord界面显示机器人已加入语音频道，但该方法始终不返回，导致后续代码无法执行，self.voice保持为None。这种情况通常是语音连接的底层初始化出现未抛出的异常，或是依赖库、版本兼容性问题导致的。

以下是针对性的排查和修复步骤：

1. 强制捕获连接异常 #

给connect()添加超时参数并包裹异常捕获，强制暴露可能隐藏的错误：

if command == "join":
    if message.author.voice != None and self.voice == None:
        chan = message.author.voice.channel
        await message.channel.send("before connecting to voice channel")
        try:
            self.voice = await chan.connect(timeout=30.0)
            await message.channel.send("after connecting to voice channel")
        except Exception as e:
            await message.channel.send(f"连接出错: {str(e)}")
            # 打印详细异常到控制台，方便排查
            print(f"Voice connect error: {e}", exc_info=True)
    else:
        await message.channel.send("Bot already connected to voice channel or user not connected to voice channel")

超时参数会强制终止阻塞的连接调用，同时捕获具体异常信息，帮助定位问题。

2. 检查并更新依赖库 #

discord.py的语音功能依赖PyNaCl，版本不兼容可能导致连接异常：

• 更新PyNaCl：

pip install --upgrade pynacl

• 同时确认discord.py为稳定版本：

pip install --upgrade discord.py

3. 替换连接状态检查逻辑 #

不要依赖self.voice变量判断连接状态，改用官方推荐的get_voice_client方法，避免变量状态不同步：

if command == "join":
    if message.author.voice is not None:
        # 检查当前服务器是否已有语音连接
        existing_voice = self.get_voice_client(message.guild)
        if existing_voice is None:
            chan = message.author.voice.channel
            await message.channel.send("before connecting to voice channel")
            try:
                self.voice = await chan.connect(timeout=30.0)
                await message.channel.send("after connecting to voice channel")
            except Exception as e:
                await message.channel.send(f"连接出错: {str(e)}")
                print(f"Voice connect error: {e}", exc_info=True)
        else:
            await message.channel.send("Bot already connected to voice channel")
    else:
        await message.channel.send("User not connected to voice channel")

这种方式直接从客户端实例获取当前服务器的语音连接状态，避免因self.voice赋值失败导致的逻辑错误。

4. 检查服务器权限 #

确认机器人在目标服务器拥有以下语音权限：

• 连接语音频道
• 发言
• 使用语音活动
  即使之前权限正常，也可能因服务器设置变更导致权限丢失，重新检查并赋予权限后测试。

5. 尝试异步任务执行连接 #

如果以上方法无效，尝试将连接操作放入独立的异步任务中，避免阻塞on_message事件循环：

import asyncio

# 在MonClient类中添加该方法
async def _connect_voice(self, chan, text_channel):
    try:
        self.voice = await chan.connect(timeout=30.0)
        await text_channel.send("after connecting to voice channel")
    except Exception as e:
        await text_channel.send(f"连接出错: {str(e)}")
        print(f"Voice connect error: {e}", exc_info=True)

# 修改join命令逻辑
if command == "join":
    if message.author.voice is not None and self.voice is None:
        chan = message.author.voice.channel
        await message.channel.send("before connecting to voice channel")
        # 创建独立任务执行连接
        asyncio.create_task(self._connect_voice(chan, message.channel))
    else:
        await message.channel.send("Bot already connected to voice channel or user not connected to voice channel")

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