Discord bot开发中Task.Delay(-1)与GetAwaiter()用法咨询

涉及的示例代码 #

static void Main(string[] args)
{
    Console.OutputEncoding = Encoding.Unicode;
    new Program().MainAsync().GetAwaiter().GetResult();
}

private DiscordSocketClient _client;

public async Task MainAsync()
{
    _client = new DiscordSocketClient();
    _client.Log += Log;
    _client.MessageReceived += _client_MessageReceived;

    var token = File.ReadAllText("token.txt");

    await _client.LoginAsync(TokenType.Bot, token);
    await _client.StartAsync();

    await Task.Delay(-1);
}

核心知识点解答 #

1. await Task.Delay(-1) 的作用

Task.Delay(毫秒数)的原生作用是创建一个指定毫秒数后自动完成的等待任务，当传入参数-1时，会生成一个永久挂起、永远不会自动完成的Task。
Discord机器人属于常驻后台的服务类程序：_client.StartAsync()执行完毕仅代表客户端启动流程走完，和Discord服务器的连接建立完成，后续需要持续保持进程运行，才能接收消息、触发注册的日志、消息响应等事件回调。如果没有这行永久等待的代码，MainAsync执行完StartAsync()就会直接走到方法末尾返回，程序进程会立刻退出，机器人直接离线。这行代码的作用就是卡住MainAsync的执行流，让程序不会主动终止。

2. GetAwaiter() 和 GetResult() 的含义

这两个是C#异步编程模型中Task类型的底层配套方法：

• GetAwaiter()：调用后会返回当前Task对应的等待器对象，该对象实现了INotifyCompletion接口，封装了Task等待完成、完成后触发回调的核心逻辑。我们日常写的await关键字，编译器在编译阶段最终就是转换成对等待器相关方法的调用，不需要开发者手动在业务代码里频繁调用。
• GetResult()：等待器对象提供的方法，作用是阻塞当前执行线程，直到对应的Task运行结束。如果Task运行中抛出异常，GetResult()会直接抛出原始异常，不会像Task.Result、Task.Wait()那样把异常嵌套包裹在AggregateException里，异常栈更清晰，排查问题成本更低，这也是异步代码同步阻塞场景下优先用GetAwaiter().GetResult()的核心原因。

3. 两者配合使用的原因

示例代码使用的是不支持async Task Main入口写法的旧版.NET，静态Main方法的返回值只能是void，没法直接在Main方法里用await等待异步逻辑执行。
如果只调用new Program().MainAsync()不做阻塞，Main方法会在发起异步调用后立刻执行完毕，主线程退出后整个进程会被系统回收，哪怕MainAsync内部有等待逻辑也不会继续执行。GetAwaiter().GetResult()的作用就是阻塞主线程，直到MainAsync返回的Task标记为完成才会继续往下执行；而Task.Delay(-1)让MainAsync的Task永远不会正常完成，最终效果就是程序一直保持运行状态，直到手动关闭进程或者出现未捕获异常才会退出。

补充：如果升级到.NET 6及以上版本，可以直接将入口方法声明为static async Task Main(string[] args)，直接在Main方法内部await所有异步逻辑即可，不需要手动写GetAwaiter().GetResult()这类适配代码。

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