ASP.NET Core 6中Discord Bot的ConnectAsync方法超时问题求助

开发者阿泽

2026-7-25

解决Discord Bot调用ConnectAsync后超时断开的问题

针对你遇到的调用ConnectAsync后机器人成功加入语音频道但挂起超时断开的问题，可通过以下几个步骤排查解决：

1. 保留音频客户端的持久引用

局部变量的audioClient可能在异步操作完成后被垃圾回收，导致连接异常断开。将其改为类级别的成员变量，维持持久引用：

private IAudioClient _audioClient; // 类级别的音频客户端引用

private async Task HandleMessageReceived(SocketMessage message)
{
    if (message.Author.Id == _client.CurrentUser.Id)
    {
        return;
    }

    else if (message.Content == "!ping")
    {
        await message.Channel.SendMessageAsync("Pong!");
    }

    else if (message.Content == "!join" && message.Author is IGuildUser guildUser)
    {
        _voiceChannel = guildUser.VoiceChannel;
        if (_voiceChannel != null)
        {
            await message.Channel.SendMessageAsync("I joined the channel.");
            // 将音频客户端赋值给类变量，避免被GC回收
            _audioClient = await guildUser.VoiceChannel.ConnectAsync();
        }
        else
        {
            await message.Channel.SendMessageAsync("You need to be in a voice channel to use this command.");
        }
    }
}

2. 使用ConfigureAwait(false)避免同步上下文死锁

ASP.NET Core的同步上下文可能导致异步方法挂起超时，在调用ConnectAsync时添加ConfigureAwait(false)：

_audioClient = await guildUser.VoiceChannel.ConnectAsync().ConfigureAwait(false);

3. 确保启用了语音相关的网关意图

创建DiscordSocketClient时，必须启用GuildVoiceStates网关意图，否则机器人无法维持语音连接：

var socketConfig = new DiscordSocketConfig
{
    GatewayIntents = GatewayIntents.AllUnprivileged | GatewayIntents.GuildVoiceStates
};
var _client = new DiscordSocketClient(socketConfig);