Vagrant无法挂载VirtualBox共享文件夹报INVALID ARGUMENT错误求助

问题根因 #

宿主机VirtualBox版本与虚拟机内安装的Guest Additions版本不兼容是触发该报错的核心原因：VirtualBox共享文件夹vboxsf文件系统的通信协议要求宿主机、虚拟机Guest Additions的大版本必须对齐，你当前宿主机版本为5.2.8，虚拟机内Guest Additions版本为6.1.22，跨大版本的差异会导致参数校验不通过，最终返回Invalid argument错误。

解决步骤 #

• 卸载虚拟机内现有6.1.22版本的Guest Additions，以Linux虚拟机为例，执行命令：

  sudo /opt/VBoxGuestAdditions-6.1.22/uninstall.sh
  

  执行完成后重启虚拟机。
• 下载和宿主机版本完全一致的5.2.8版本VirtualBox Guest Additions镜像，挂载到虚拟机的虚拟光驱后完成安装，安装后再次重启虚拟机。
• 执行vagrant reload重启Vagrant实例，验证共享文件夹是否可以正常挂载。

额外排查点 #

如果上述操作完成后仍然报错，可以按以下步骤排查：

• 确认虚拟机内已安装对应内核版本的内核头文件，安装Guest Additions过程中没有出现内核模块编译失败的报错
• 手动执行挂载命令测试，查看详细报错：

  sudo mount -t vboxsf vagrant /vagrant
  

• 查看内核日志定位具体错误原因：

  dmesg | grep vboxsf
  

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