执行Vagrant halt/reload后VirtualBox Headless Frontend进程未停止问题

你遇到的如下启动报错：

Command: ["startvm", "c76a8bec-7a40-47c9-b01f-1c8b2b0a7def", "--type", "headless"]

Stderr: VBoxManage.exe: error: The VM session was closed before any attempt to power it on VBoxManage.exe: error: Details: code E_FAIL (0x80004005), component SessionMachine, interface ISession

本质是Windows平台下vagrant halt/vagrant reload执行后，VirtualBox对应虚拟机进程残留导致的，具体原因和解决方法如下：

进程未被自动清除的原因 #

• 权限不足：Windows下运行Vagrant的终端如果没有管理员权限，命令下发后没有权限终止VBoxHeadless.exe、VBoxManage.exe这类VirtualBox后台进程，就会出现进程残留，VirtualBox会判定对应虚拟机的会话仍被占用，无法启动新会话
• 版本适配缺陷：你使用的Vagrant 2.2与VirtualBox 6.1的部分小版本存在适配问题，Vagrant调用VirtualBox接口下发关机/重启指令后，没有等待进程完全退出就结束了自身命令执行，导致进程没有被正确回收
• 进程无响应：如果虚拟机运行过程中出现IO卡顿、网络异常等问题，VirtualBox的虚拟机进程可能进入无响应状态，无法接收Vagrant下发的终止信号，最终导致进程残留
  注：vagrant halt和vagrant reload命令本身的设计逻辑是会终止对应虚拟机进程的，不属于功能设计缺失

永久修复方案 #

• 所有Vagrant命令都在管理员身份运行的终端中执行，规避权限限制
• 在项目的Vagrantfile中添加后置触发器，执行halt后自动清理残留进程：

config.trigger.after :halt do |trigger|
  trigger.warn = "Cleaning up residual VirtualBox processes"
  trigger.run = {inline: "taskkill /IM VBoxHeadless.exe /F /T 2>nul"}
end

• 升级到Vagrant 2.3+、VirtualBox 6.1.40及以上版本，该适配问题已经在后续版本中被修复

临时处理方案 #

已经出现报错时，直接在终端执行如下命令即可批量清理残留进程，无需手动打开任务管理器操作：
taskkill /IM VBoxHeadless.exe /F /T

内容的提问来源于stack exchange，提问作者Arnold Joseph Fudolig