如何修复Hyper-V问题？执行vagrant up --provision时遇报错求助

我常年处理Vagrant+Hyper-V的部署问题，下面是几个最容易触发报错的场景以及对应的解决办法，你可以按顺序排查：

1. Hyper-V未启用或权限不足 #

• 先确认Hyper-V功能已经开启：按下Win+X打开管理员身份的Windows PowerShell，执行命令：

  Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
  

  执行完成后重启电脑生效。
• 一定要用管理员权限运行终端/命令提示符，Vagrant操作Hyper-V虚拟机需要系统级权限，普通用户执行大概率会报错。

2. 虚拟交换机配置缺失或错误 #

Hyper-V依赖正确的虚拟交换机实现虚拟机联网，这是最常见的报错原因：

• 打开Hyper-V管理器，点击左侧的「虚拟交换机管理器」，检查是否存在外部类型的虚拟交换机（绑定到你的物理网卡）。如果没有，新建一个：
  • 选择「外部」类型，点击创建，绑定到当前正在使用的物理网卡，取消勾选「允许管理操作系统共享此网络适配器」（避免网络冲突）。
• 打开你的Vagrantfile，添加或修改网络配置，指定刚才创建的交换机名称：

  config.vm.network "public_network", bridge: "你的外部交换机名称"
  

  保存后重新执行vagrant up --provision。

3. Vagrant Box与Hyper-V不兼容 #

部分第三方Vagrant Box没有针对Hyper-V做优化，会导致启动失败：

• 重新添加官方兼容Hyper-V的Box，比如Ubuntu 20.04的命令：

  vagrant box add ubuntu/focal64 --provider hyperv
  

• 在Vagrantfile里明确指定Hyper-V作为 provider，并配置资源参数：

  config.vm.provider "hyperv" do |hv|
    hv.cpus = 2
    hv.memory = 2048 # 按需调整内存大小
  end
  

4. 残留虚拟机文件损坏 #

如果之前的虚拟机启动失败，可能留下了损坏的虚拟硬盘或配置文件：

• 先执行vagrant destroy -f彻底删除现有虚拟机实例；
• 打开Hyper-V管理器，手动删除未清理干净的虚拟机、虚拟硬盘文件；
• 重新执行vagrant up --provision重新创建虚拟机。

5. 防火墙/杀毒软件拦截 #

Windows Defender防火墙或第三方杀毒软件可能会阻止Vagrant与Hyper-V的通信：

• 临时关闭防火墙和杀毒软件，再次尝试执行命令；
• 如果成功，将Vagrant程序（vagrant.exe）以及Hyper-V相关服务加入防火墙白名单，避免后续拦截。

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