Proto.Actor中ActorSystem.ShutdownAsync()是否会停止所有Actor？

ActorSystem.ShutdownAsync()返回的Task标记完成的节点是系统核心调度器停止、根守护者Actor终止，并不覆盖所有自定义子Actor的停止、IDisposable.Dispose流程。默认停止指令是从根节点向下异步传导的，如果直接await该方法后就退出进程，很容易出现下层Actor还没走完清理流程就被强制终止的情况。

正确操作步骤 #

• 优先触发用户级Actor的优雅停止，不要直接调用系统Shutdown
  先给所有你创建的顶级用户Actor发送停止信号，不要直接操作底层子Actor。可以借助GracefulStop扩展方法获取单个Actor停止完成的Task，设置合理超时后等待所有顶级Actor停止完毕，参考代码：

  // 传入你自己维护的所有顶级Actor引用列表，设置10秒停止超时
  var actorStopTasks = topLevelActorRefs.Select(actor => 
      actor.GracefulStop(TimeSpan.FromSeconds(10))
  );
  await Task.WhenAll(actorStopTasks);
  

  父Actor收到停止信号后，会自动按顺序等待所有子Actor完成停止流程，再执行自身的清理逻辑，不需要手动给每个子Actor发停止指令。
• 把清理逻辑绑定到Actor生命周期钩子上
  不要仅依赖IDisposable.Dispose做核心清理，Actor的PostStop()生命周期方法是停止流程中一定会被触发的钩子，优先把资源释放、消息收尾的逻辑放在这里。
  如果保留IDisposable实现，要确认Actor配置没有开启SuppressDispose选项，默认配置下Actor走完PostStop流程后会自动调用Dispose方法，前提是Actor的停止流程没有被强制中断。
• 最后执行系统Shutdown
  等所有用户级Actor全部停止完成后，再调用await actorSystem.ShutdownAsync()，此时Shutdown流程只会清理系统内部核心组件，不会出现用户Actor未完成Dispose的问题。注意不要在await ShutdownAsync之后立刻调用强制进程退出的方法，等Task执行完成后再结束程序入口即可。

常见问题规避 #

• 不要用强制停止接口终止Actor，这类接口不会等待Actor邮箱内剩余消息处理完成，会直接中断清理流程。
• 如果Actor内部运行了长时阻塞任务，要在PostStop里通过取消令牌触发长任务终止，避免卡住整个停止流程触发超时。
• 不要跨层级手动给子Actor发停止消息，会打乱父Actor监督的默认停止顺序，容易出现资源释放顺序错误。

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