深夜调虚拟机的时候最怕看到的一句话大概就是指定的文件不是虚拟磁盘。你明明只是关了机、挪了个目录、或者从旧硬盘里把虚拟机整个拷过来结果一开机 VMware 就甩给你这么一句电源键点下去毫无反应配置也不给你改。这个报错的杀伤力在于它不像蓝屏那样把问题摆在明面上而是直接卡在识别磁盘这一步虚拟机连 BIOS 都进不去你连个救援模式都摸不着边。这篇文章就把我这些年处理这个报错的完整思路摊开讲先搞清楚虚拟磁盘文件到底由什么组成再判断是描述符丢了、快照链断了还是你拷文件的方式出了问题最后给出可以照着抄的描述符重建模板和官方修复命令。不管你是刚装完 VMware 想跑第一个 Linux 的新手还是手上一堆测试机、天天在 Workstation 和 ESXi 之间搬磁盘的老手这套排查路径都能直接用。文中所有命令我都会说明为什么这么写参数是怎么算出来的以及哪些操作一旦做错就再也回不来。1. 先把报错翻译成人话VMware 到底在抱怨什么1.1 一个 vmdk 其实是两件套很多人以为虚拟机磁盘就是一个大文件其实在绝大多数场景下你看到的那个 xxx.vmdk 只是描述符真正的数据躺在旁边一个叫 xxx-flat.vmdk 的文件里。描述符是个几 KB 的纯文本用记事本就能打开里面写着这块盘有多大、多少个扇区、用什么控制器类型、父盘是谁而 -flat 结尾的那个才是货真价实的几十上百 GB 的二进制数据。VMware 开机时会先读描述符根据里面的 extent 行去找对应的数据文件找到之后再核对 CID、几何参数这些信息全部对上了才把磁盘挂给虚拟机。指定的文件不是虚拟磁盘这句话本质上是 VMware 读描述符这一步就失败了。它打开你指定的那个文件期望在开头看到# Disk DescriptorFile这样的标识结果看到的是二进制乱码或者干脆是个 0 字节的空文件于是它判定这不是我要的东西。所以这个报错和磁盘损坏数据丢了是两码事绝大多数情况下数据都还好好地躺在 -flat 文件里坏的只是那张身份证。我见过最典型的场景是有人用文件管理器把虚拟机目录拖到移动硬盘中途 -flat 文件被某个同步工具单独锁住没拷完描述符拷过去了数据文件只拷了一半也有人为了省空间把 -flat 文件删了以为虚拟机还能跑。这两种情况报错信息一模一样但处理方式完全不同所以在动手之前先别急着删文件、更别急着重建虚拟机。1.2 不是虚拟磁盘这句话的三层含义第一种含义是字面意思文件格式不对。VMware Workstation 的虚拟磁盘有几个变种monolithicSparse是单个文件自包含的monolithicFlat和twoGbMaxExtentFlat是描述符加数据文件分离的vmfs系列是给 ESXi 用的。你如果拿一个从别的地方转出来的 raw 镜像、img 文件或者把 VirtualBox 的 vdi 直接改名成 vmdkVMware 自然不认。判断方法很简单用十六进制看一眼文件头就行head -c 16 xxx.vmdk | xxd一看就知道。第二种含义是描述符内容对不上。文件头没问题确实是文本但里面写的 extent 指向的文件名在当前目录下不存在或者扇区数和实际数据文件大小对不上。这种情况常见于改过虚拟机名字、挪过目录、或者用脚本批量重命名过文件之后。VMware 读到 extent 行去磁盘上找那个名字找不到或者找到了但大小不匹配同样会报这个错。第三种含义是快照链断裂。只要虚拟机做过快照磁盘就变成了一条链基础盘 -flat 是根上面挂着 -000001.vmdk、-000002.vmdk 这些增量盘每个增量盘的描述符里都有parentCID和parentFileNameHint指向它的上一级。如果中间某一级被误删、被单独拷走或者 CID 被人手工改过整条链就断了VMware 在解析时会认为磁盘结构非法报错表现和格式错误几乎一样。快照链的问题最麻烦因为即便你能让虚拟机开机也大概率会丢最近的快照状态所以这一类要放在最后处理先确认基础盘是不是完好的。注意判断问题属于哪一层靠的是看文件头、看描述符内容、看目录里都有哪些文件而不是靠猜。把这三步做完再动手能省掉 80% 的无用功。2. 动手前的固定现场三步锁定坏在哪个环节2.1 从 vmx 反查真正的罪魁祸首报错弹出的时候大多数人第一反应是点确定然后重开虚拟机来回几次也没个头绪。我现在的习惯是第一步就去看配置文件。虚拟机目录里那个和虚拟机同名的 .vmx 文件才是总纲里面scsi0:0.fileName win10.vmdk或者nvme0:0.fileName 这样的行明确告诉你这台机器挂的是哪个磁盘文件。一个虚拟机可以挂好几块盘报错不一定来自你正在盯着的那一块尤其是那些做过加新盘做备份的机器。打开 vmx 之后要做两件事第一把每一行 fileName 都记下来逐个确认文件还在不在目录里第二顺便看一眼scsi0:0.present TRUE和控制器类型scsi0.virtualDev lsilogic。控制器类型和描述符里的ddb.adapterType如果对不上有些版本的 VMware 也会在挂盘阶段出幺蛾子。这一步花不了一分钟但能直接排除掉其实坏的是另一块盘这种低级方向性错误。我吃过一次亏一台测试机报这个错我盯着 C 盘那块 vmdk 折腾了两个小时重建描述符、换格式、查快照全试了一遍还是不行。最后翻了 vmx 才发现虚拟机还挂着一块早就被删掉的 D 盘报错根本是 D 盘引起的。所以顺序不能反先看 vmx 确认要修哪块再动手。另外要提醒一句编辑 vmx 之前一定先复制一份出来命名成 xxx.vmx.bak。这个文件是纯文本改错一个字就可能让虚拟机直接无法识别硬件比磁盘报错还难收拾。2.2 用文件头判断 vmdk 是文本还是砖头确认了目标磁盘之后下一个动作是看它到底是描述符还是数据文件。Linux 或者装了 Git Bash、WSL 的 Windows 上一条命令就能定性head -c 64 win10.vmdk | xxd如果输出里能看到23 20 44 69 73 6b 20 44 65 73 63这一串翻译过来就是# Disk Desc说明这是正经的描述符文本。如果看到的是一堆0000 0000或者毫无规律的数据那说明你手上这个是数据文件被错误地当成了描述符或者文件被某种工具加密、压缩过。Windows 上没有 xxd 也不慌用记事本强行打开能正常显示文字的说明是描述符显示一堆方框和乱码的就是二进制数据。这个方法土但可靠我到现在还经常用。还有一点要留意文件大小正常描述符一般 1KB 到 4KB超过 100KB 的所谓 vmdk 大概率是数据文件。而那些标着-flat、-s001、-delta、-000001结尾的文件天生的角色就是数据不用去纠结它们的文件头。判断清楚我手里是描述符还是数据是整个修复流程的分水岭。是描述符就往下看内容对不对是数据文件就说明描述符丢了需要重建。2.3 备份与日志动手前必须做的两件事虚拟机的修复操作里有一条铁律动手之前先把整个目录复制一份哪怕你有几百 GB 的 -flat 文件也别省这个时间。如果实在没空间至少把 vmx、所有 vmdk 描述符不包括 -flat复制到别的地方这些加起来通常不到 1MB出问题了还能对照着还原。第二件事是看日志。虚拟机目录下会有 vmware.log报错发生的那次启动记录就在里面搜not a virtual disk、Cannot open、Failed to open这几个关键词日志里的报错往往比弹窗详细得多它会告诉你是哪个文件、哪一行、因为什么原因读失败。我处理过一个案例弹窗只说不是虚拟磁盘日志里写的却是extent file size mismatch: expected 41943040 sectors, got 20971520直接点明数据文件只有预期的一半——这是拷贝过程中断造成的比盲猜快太多。提示如果虚拟机是 Windows 上的 Workstation日志默认就在虚拟机目录下如果是 ESXi 上的虚拟机日志在数据存储的虚拟机目录里也可以通过 vSphere Client 的监控-事件看一眼。养成先读日志的习惯修复效率会翻倍。3. 手动重建描述符文件最硬核也最管用的一招3.1 扇区数怎么算一个都不能错重建描述符最容易翻车的地方就是扇区数。VMware 描述符里的 extent 行写的是扇区数量不是字节数也不是 GB 数而虚拟磁盘定义的一个扇区是 512 字节这个值从古到今没变过。所以计算方式非常直接# 在 Linux/Git Bash 下查看数据文件大小字节 ls -l win10-flat.vmdk # 假设输出 21474836480 字节20GB # 扇区数 21474836480 / 512 4194304041943040 这个数字就是 extent 行里要写的东西。有人喜欢用 GB 去乘 1024 再乘 1024 再乘 1024 再除 512数学上等价但中间容易多算少算一个 1024我一般直接用stat -c %s拿到精确字节数再整除 512稳妥。对于twoGbMaxExtentFlat这种把大磁盘切成多个 2GB 文件的格式就要挨个文件算然后每个文件写一行 extent从第一块到最后一块按顺序排。假设你有 win10-f001.vmdk 到 win10-f010.vmdk 十个文件就要写十行RW 扇区数 FLAT win10-f00X.vmdk 0。这十行的扇区数加起来必须正好等于原磁盘的总扇区数差一个扇区 VMware 都可能报错或者识别成错误容量。这里有个经验值可以参考大部分 2GB 切片的 flat 文件大小是 2097152000 字节左右除 512 是 4096000 扇区写进描述符里用这个数字基本不会错。但最保险的还是实测因为有些工具生成的切片会带一点点差异。3.2 一份可直接抄的描述符模板Workstation 场景假设场景是这样的目录里有win10-flat.vmdk大小 21474836480 字节扇区数 41943040你需要在同目录下新建一个win10.vmdk文本文件内容如下# Disk DescriptorFile version1 encodingUTF-8 CIDfffffffe parentCIDffffffff createTypemonolithicFlat # Extent description RW 41943040 FLAT win10-flat.vmdk 0 # The Disk Data Base #DDB ddb.adapterType lsilogic ddb.geometry.cylinders 2610 ddb.geometry.heads 255 ddb.geometry.sectors 63 ddb.virtualHWVersion 17 ddb.uuid 60 00 C2 9d 3a 4f 8b 21-9c 6e 0d 44 12 8a 5f 71 ddb.longContentID a1b2c3d4e5f60718293a4b5c6d7e8f90逐行解释一下。CID是当前磁盘的内容标识独立磁盘没有快照随便写一个 8 位十六进制都行我习惯用 fffffffe但不要写 ffffffff那是给 parentCID 保留的。parentCIDffffffff表示我没有父盘独立磁盘就该这么写。createType要和实际文件结构匹配单文件用monolithicSparse描述符加 flat 用monolithicFlat多切片用twoGbMaxExtentFlat。ddb.geometry这三行是老 BIOS 时代留下的 CHS 参数现代虚拟机基本都用 LBA 寻址写个近似值就行公式是 柱面数 总扇区数 ÷ (255 × 63)。41943040 ÷ 16065 ≈ 2610.9取整写 2610 即可写 2611 也不会导致数据损坏因为它只是给老系统看的兼容信息不参与实际读写。ddb.uuid里那 16 个字节随便填合法十六进制就行全目录唯一最好实在懒得想用上一台机器的改一个字符也能跑起来。ddb.adapterType一定要和你 vmx 里的控制器一致vmx 写 lsilogic 这里就写 lsilogic写错会出现能识别磁盘但系统找不到硬盘的怪现象。3.3 快照链断裂时的取舍救数据还是救时间带快照的虚拟机磁盘结构是这样的win10.vmdk是基础盘描述符指向win10-flat.vmdkwin10-000001.vmdk是第一个快照的增量盘描述符里面parentCID指向基础盘的 CIDparentFileNameHint指向基础盘路径win10-000001-delta.vmdk才是增量的数据。整个链条一环扣一环CID 必须严丝合缝。如果你的 vmx 里挂的是win10-000001.vmdk报错也指向它那先别管它去看看基础盘win10.vmdk和win10-flat.vmdk是不是完好的。如果基础盘好的增量盘坏了最稳妥的做法是放弃快照把 vmx 里的 fileName 改回win10.vmdk虚拟机就能开起来代价是恢复到做快照之前的状态。快照里的数据能不能救可以试试手工修增量盘的描述符把 parentCID 和 parentFileNameHint 补对但这个操作成功率不算高尤其是链条断在中间层的时候。我的建议是生产数据和长期积累的测试环境优先保基础盘随手做的一次性快照直接放弃。曾经为了让一个三步快照链跑起来我把 CID 一层层还原折腾了三个小时结果开机后文件系统还是提示要 chkdsk因为中间某一步的增量数据本身就不完整。那次之后我的原则就变成——快照不是备份坏了就别救趁早回到基础盘。注意手工重建描述符之前把原始的描述符文件改名保留比如win10.vmdk.orig别直接覆盖。修不好可以立刻还原这个习惯救过我好几回。4. 官方工具能救的场合别急着当手工党4.1 vmware-vdiskmanager 的修复与检查Workstation 装完之后安装目录里有个vmware-vdiskmanager.exeLinux 版是vmware-vdiskmanager这东西专门管虚拟磁盘。遇到不是虚拟磁盘这种识别类错误先用它检查一遍# Windows 下在 Workstation 安装目录里执行 vmware-vdiskmanager.exe -e D:\VMs\win10\win10.vmdk # Linux 下 vmware-vdiskmanager -e /home/user/vms/win10/win10.vmdk-e是检查磁盘完整性的它会尝试解析描述符、核对 extent 文件、检查快照链能修一些小毛病。如果检查通过但开机还是报错可以试试-R参数重建描述符vmware-vdiskmanager -R D:\VMs\win10\win10.vmdk-R会尝试根据数据文件重新生成描述符。但要注意这个命令在有些版本上对monolithicFlat支持良好对快照链和稀疏格式就未必管用而且它执行的时候不会问你要不要覆盖所以前面说的备份一步都不能省。我的经验是能用官方工具解决的场景大概占三成多半是描述符轻微损坏、PID 和 CID 不匹配这种剩下七成还是得靠手工建描述符或者找回正确的文件组合。还有两个实用参数顺手记一下-x 60GB是用来扩容的-d是指定磁盘格式的配合-i可以从一个磁盘克隆出另一个并顺便转换成所需格式。遇到格式不兼容类的报错用-i转一次格式往往比手工捣鼓快得多。4.2 ESXi 侧 vmkfstools 的用法差异如果虚拟机跑在 ESXi 上工具就换成 vmkfstools 了这个命令只能在 ESXi Shell 或者 SSH 进去之后用。检查磁盘一致性vmkfstools -e /vmfs/volumes/datastore1/win10/win10.vmdk转换格式或者克隆修复vmkfstools -i /vmfs/volumes/datastore1/win10/win10.vmdk -d thin /vmfs/volumes/datastore1/win10-new/win10.vmdk-d thin是精简置备-d thick是厚置备-d zeroedthick是延迟置零的厚置备。出了问题最常用的其实是-i克隆只要原始 vmdk 还能被 vmkfstools 读出来克隆一遍就能生成一份结构规整的新磁盘接着把 vmx 里的文件名改过去就能开机。这个思路的好处是不动原始文件出问题最多浪费点存储空间。不过 ESXi 上有个坑要提醒如果你在 vCenter 里看到的是 ESXi 虚拟机但磁盘文件 timeout 或者连 -e 都报错那可能不是描述符的问题而是数据存储本身有故障比如存储掉线、快照文件被某个备份任务锁住。这时候先解决存储层面的事情别一味修磁盘文件。我遇到过一次折腾了半天描述符最后发现是 iSCSI 链路抖动存储重新挂载之后虚拟机自己就好了。5. 那些看起来像磁盘坏了其实是别的问题5.1 挂载、导入与格式转换踩的雷有一类指定的文件不是虚拟磁盘并不是虚拟机本身的问题而是你试图用不合适的方式去碰它。最常见的三种一是用 Workstation 的映射虚拟磁盘功能去挂载一块 ESXi 格式的磁盘二是从 VirtualBox、Hyper-V 导过来的镜像直接改名塞进虚拟机三是把某个分区备份工具生成的 img/raw 文件当成 vmdk 用。这三种情况文件本身没错错的是身份和用途需要的是转换而不是修复。转换思路也比较固定VirtualBox 的 vdi 用VBoxManage clonemedium转成 vmdkHyper-V 的 vhdx 一般先转成 vhd再用 qemu-img 转成 vmdk裸的 raw 镜像可以用qemu-img convert -f raw -O vmdk直接生成。这类转换工具生成的 vmdk 本身就是自包含的或是标准 flat 格式VMware 直接就能认不用手工写描述符。还有一类是名字惹的祸。目录名、文件名里带中文、空格、特殊符号或者拷贝时被网盘、同步软件加上了(1)后缀导致描述符里的 extent 行和实际文件名对不上。这种情况连重建都不用把文件名改回去、把后缀去掉问题就解决了。我现在的习惯是虚拟机目录只用英文、数字和下划线看着土但从来不因为这个出问题。5.2 网络适配器、虚拟化开关这类周边报错搜这个报错的时候你会发现旁边总会冒出一堆看着不相关的词虚拟网络适配器带感叹号、vmnet1 有黄色标记、虚拟机没有网络适配器、装 Linux 蓝屏、装 Windows 11 提示 boot 相关错误、WSL2 提示没有启用虚拟化。这些东西虽然和不是虚拟磁盘不是一回事但经常同框出现因为它们都指向同一个底层状态——虚拟化环境本身没配好。遇到这一类排查顺序应该是先宿主机、后虚拟机。Windows 上打开启用或关闭 Windows 功能确认虚拟机平台相关的组件是勾上的宿主机 BIOS 里确认 CPU 虚拟化是开着的这一步漏了的话虚拟机不是启动慢就是各种反常。虚拟网卡带感叹号多半是虚拟网络驱动没装好卸载网络适配器驱动再让 Workstation 重装一遍通常就能恢复。至于安装 Linux 时蓝屏或者进不去图形界面那是 guest 系统层面的问题跟磁盘文件是否损坏没有关系别把它和今天的主题搅在一起。我的经验是把问题分层宿主机虚拟化开关是一层VMware 主程序与驱动是一层虚拟机配置文件是一层guest 系统是另一层。报错提示在哪一层就先在哪一层找。很多新手把所有问题混在一起调最后改乱了配置反而把本来好的东西也搞崩了。6. 问题速查表与日常防坑习惯6.1 一表速查下面这张表是我这些年遇到过的指定的文件不是虚拟磁盘的完整对照按现象找方向比一上来就乱试快得多。现象最可能原因处理方向记事本打开 vmdk 是乱码打开的是数据文件找同名描述符缺失则手工重建vmdk 只有 0KB描述符被截断或没拷完从备份找回或按数据文件重建描述符里 extent 指向的文件不存在改过名、挪过目录改文件名或改描述符里的路径大小不匹配告警拷贝中断、数据文件不完整重新拷贝或核对扇区数挂 -000001.vmdk 报错基础盘正常快照链断裂改 vmx 挂回基础盘放弃快照从别处拷来的整机打不开路径、CID、格式不匹配用 vdiskmanager 检查、克隆转换导入 VirtualBox/Hyper-V 镜像格式本身不同用转换工具生成标准 vmdk数据存储偶发掉线后报错存储链路问题先修存储再验证磁盘这张表的关键不在于准而在于帮你把猜变成看。每次处理完我都会顺手在虚拟机目录里放一个 readme写清楚这次是什么原因、怎么修的下次再出问题五分钟就能定位。6.2 我踩过的坑和我现在的规矩第一个坑是直接删文件腾空间。早年硬盘紧张我看 -flat 文件占地方以为删了虚拟机还能按描述符恢复结果是数据全没了描述符还在报错就是这一句。这块教训让我明白描述符和数据文件是一体的删哪个都不行。第二个坑是用错工具拷大文件。虚拟机目录动辄几百 GB用某些同步软件或者带断点续传的复制工具表面显示完成实际有几个文件没同步完整尤其是 -flat 这种大文件最容易出问题。我现在的规矩是虚拟机整机迁移一律用压缩包先打包再拷拷完必须校验文件大小和哈希绝不相信进度条到 100% 了。第三个坑是在虚拟机运行时操作文件。有人看着虚拟机里看不到那块盘就直接去宿主机上删文件或者在开机状态下挪目录报错自然跟着来。任何对虚拟机目录的改动都必须先彻底关机确认 VMware 进程不再占用文件再动手。Windows 上可以用资源监视器搜一下哪个进程锁着 vmdkLinux 上用 lsof确认干净了再操作。第四个坑是描述符里参数乱填。看着网上某个模板就照抄结果 createType 和实际文件结构不一致adapterType 和 vmx 对不上geometry 差得离谱能开机是运气开不了机是常态。我现在写描述符的固定流程是算扇区数、对 createType、对 adapterType、CID 和 parentCID 按是否有快照决定四个步骤逐个核对不跳步。最后分享一个我现在的备份习惯每台重要的虚拟机除了完整备份之外我都会单独把 vmx 和所有描述符文件不含 -flat复制到一个config-backup目录里整个目录也就几百 KB。这个习惯的价值在于哪天描述符真丢了可以照着备份里的内容重建连 UUID、几何参数都不用重新算。虚拟机这东西最贵的从来不是那几百 GB 的盘而是你花在上面配置好的环境和时间把配置文件看住了剩下的都好办。
VMware“指定的文件不是虚拟磁盘”排查与VMDK描述符重建
深夜调虚拟机的时候最怕看到的一句话大概就是指定的文件不是虚拟磁盘。你明明只是关了机、挪了个目录、或者从旧硬盘里把虚拟机整个拷过来结果一开机 VMware 就甩给你这么一句电源键点下去毫无反应配置也不给你改。这个报错的杀伤力在于它不像蓝屏那样把问题摆在明面上而是直接卡在识别磁盘这一步虚拟机连 BIOS 都进不去你连个救援模式都摸不着边。这篇文章就把我这些年处理这个报错的完整思路摊开讲先搞清楚虚拟磁盘文件到底由什么组成再判断是描述符丢了、快照链断了还是你拷文件的方式出了问题最后给出可以照着抄的描述符重建模板和官方修复命令。不管你是刚装完 VMware 想跑第一个 Linux 的新手还是手上一堆测试机、天天在 Workstation 和 ESXi 之间搬磁盘的老手这套排查路径都能直接用。文中所有命令我都会说明为什么这么写参数是怎么算出来的以及哪些操作一旦做错就再也回不来。1. 先把报错翻译成人话VMware 到底在抱怨什么1.1 一个 vmdk 其实是两件套很多人以为虚拟机磁盘就是一个大文件其实在绝大多数场景下你看到的那个 xxx.vmdk 只是描述符真正的数据躺在旁边一个叫 xxx-flat.vmdk 的文件里。描述符是个几 KB 的纯文本用记事本就能打开里面写着这块盘有多大、多少个扇区、用什么控制器类型、父盘是谁而 -flat 结尾的那个才是货真价实的几十上百 GB 的二进制数据。VMware 开机时会先读描述符根据里面的 extent 行去找对应的数据文件找到之后再核对 CID、几何参数这些信息全部对上了才把磁盘挂给虚拟机。指定的文件不是虚拟磁盘这句话本质上是 VMware 读描述符这一步就失败了。它打开你指定的那个文件期望在开头看到# Disk DescriptorFile这样的标识结果看到的是二进制乱码或者干脆是个 0 字节的空文件于是它判定这不是我要的东西。所以这个报错和磁盘损坏数据丢了是两码事绝大多数情况下数据都还好好地躺在 -flat 文件里坏的只是那张身份证。我见过最典型的场景是有人用文件管理器把虚拟机目录拖到移动硬盘中途 -flat 文件被某个同步工具单独锁住没拷完描述符拷过去了数据文件只拷了一半也有人为了省空间把 -flat 文件删了以为虚拟机还能跑。这两种情况报错信息一模一样但处理方式完全不同所以在动手之前先别急着删文件、更别急着重建虚拟机。1.2 不是虚拟磁盘这句话的三层含义第一种含义是字面意思文件格式不对。VMware Workstation 的虚拟磁盘有几个变种monolithicSparse是单个文件自包含的monolithicFlat和twoGbMaxExtentFlat是描述符加数据文件分离的vmfs系列是给 ESXi 用的。你如果拿一个从别的地方转出来的 raw 镜像、img 文件或者把 VirtualBox 的 vdi 直接改名成 vmdkVMware 自然不认。判断方法很简单用十六进制看一眼文件头就行head -c 16 xxx.vmdk | xxd一看就知道。第二种含义是描述符内容对不上。文件头没问题确实是文本但里面写的 extent 指向的文件名在当前目录下不存在或者扇区数和实际数据文件大小对不上。这种情况常见于改过虚拟机名字、挪过目录、或者用脚本批量重命名过文件之后。VMware 读到 extent 行去磁盘上找那个名字找不到或者找到了但大小不匹配同样会报这个错。第三种含义是快照链断裂。只要虚拟机做过快照磁盘就变成了一条链基础盘 -flat 是根上面挂着 -000001.vmdk、-000002.vmdk 这些增量盘每个增量盘的描述符里都有parentCID和parentFileNameHint指向它的上一级。如果中间某一级被误删、被单独拷走或者 CID 被人手工改过整条链就断了VMware 在解析时会认为磁盘结构非法报错表现和格式错误几乎一样。快照链的问题最麻烦因为即便你能让虚拟机开机也大概率会丢最近的快照状态所以这一类要放在最后处理先确认基础盘是不是完好的。注意判断问题属于哪一层靠的是看文件头、看描述符内容、看目录里都有哪些文件而不是靠猜。把这三步做完再动手能省掉 80% 的无用功。2. 动手前的固定现场三步锁定坏在哪个环节2.1 从 vmx 反查真正的罪魁祸首报错弹出的时候大多数人第一反应是点确定然后重开虚拟机来回几次也没个头绪。我现在的习惯是第一步就去看配置文件。虚拟机目录里那个和虚拟机同名的 .vmx 文件才是总纲里面scsi0:0.fileName win10.vmdk或者nvme0:0.fileName 这样的行明确告诉你这台机器挂的是哪个磁盘文件。一个虚拟机可以挂好几块盘报错不一定来自你正在盯着的那一块尤其是那些做过加新盘做备份的机器。打开 vmx 之后要做两件事第一把每一行 fileName 都记下来逐个确认文件还在不在目录里第二顺便看一眼scsi0:0.present TRUE和控制器类型scsi0.virtualDev lsilogic。控制器类型和描述符里的ddb.adapterType如果对不上有些版本的 VMware 也会在挂盘阶段出幺蛾子。这一步花不了一分钟但能直接排除掉其实坏的是另一块盘这种低级方向性错误。我吃过一次亏一台测试机报这个错我盯着 C 盘那块 vmdk 折腾了两个小时重建描述符、换格式、查快照全试了一遍还是不行。最后翻了 vmx 才发现虚拟机还挂着一块早就被删掉的 D 盘报错根本是 D 盘引起的。所以顺序不能反先看 vmx 确认要修哪块再动手。另外要提醒一句编辑 vmx 之前一定先复制一份出来命名成 xxx.vmx.bak。这个文件是纯文本改错一个字就可能让虚拟机直接无法识别硬件比磁盘报错还难收拾。2.2 用文件头判断 vmdk 是文本还是砖头确认了目标磁盘之后下一个动作是看它到底是描述符还是数据文件。Linux 或者装了 Git Bash、WSL 的 Windows 上一条命令就能定性head -c 64 win10.vmdk | xxd如果输出里能看到23 20 44 69 73 6b 20 44 65 73 63这一串翻译过来就是# Disk Desc说明这是正经的描述符文本。如果看到的是一堆0000 0000或者毫无规律的数据那说明你手上这个是数据文件被错误地当成了描述符或者文件被某种工具加密、压缩过。Windows 上没有 xxd 也不慌用记事本强行打开能正常显示文字的说明是描述符显示一堆方框和乱码的就是二进制数据。这个方法土但可靠我到现在还经常用。还有一点要留意文件大小正常描述符一般 1KB 到 4KB超过 100KB 的所谓 vmdk 大概率是数据文件。而那些标着-flat、-s001、-delta、-000001结尾的文件天生的角色就是数据不用去纠结它们的文件头。判断清楚我手里是描述符还是数据是整个修复流程的分水岭。是描述符就往下看内容对不对是数据文件就说明描述符丢了需要重建。2.3 备份与日志动手前必须做的两件事虚拟机的修复操作里有一条铁律动手之前先把整个目录复制一份哪怕你有几百 GB 的 -flat 文件也别省这个时间。如果实在没空间至少把 vmx、所有 vmdk 描述符不包括 -flat复制到别的地方这些加起来通常不到 1MB出问题了还能对照着还原。第二件事是看日志。虚拟机目录下会有 vmware.log报错发生的那次启动记录就在里面搜not a virtual disk、Cannot open、Failed to open这几个关键词日志里的报错往往比弹窗详细得多它会告诉你是哪个文件、哪一行、因为什么原因读失败。我处理过一个案例弹窗只说不是虚拟磁盘日志里写的却是extent file size mismatch: expected 41943040 sectors, got 20971520直接点明数据文件只有预期的一半——这是拷贝过程中断造成的比盲猜快太多。提示如果虚拟机是 Windows 上的 Workstation日志默认就在虚拟机目录下如果是 ESXi 上的虚拟机日志在数据存储的虚拟机目录里也可以通过 vSphere Client 的监控-事件看一眼。养成先读日志的习惯修复效率会翻倍。3. 手动重建描述符文件最硬核也最管用的一招3.1 扇区数怎么算一个都不能错重建描述符最容易翻车的地方就是扇区数。VMware 描述符里的 extent 行写的是扇区数量不是字节数也不是 GB 数而虚拟磁盘定义的一个扇区是 512 字节这个值从古到今没变过。所以计算方式非常直接# 在 Linux/Git Bash 下查看数据文件大小字节 ls -l win10-flat.vmdk # 假设输出 21474836480 字节20GB # 扇区数 21474836480 / 512 4194304041943040 这个数字就是 extent 行里要写的东西。有人喜欢用 GB 去乘 1024 再乘 1024 再乘 1024 再除 512数学上等价但中间容易多算少算一个 1024我一般直接用stat -c %s拿到精确字节数再整除 512稳妥。对于twoGbMaxExtentFlat这种把大磁盘切成多个 2GB 文件的格式就要挨个文件算然后每个文件写一行 extent从第一块到最后一块按顺序排。假设你有 win10-f001.vmdk 到 win10-f010.vmdk 十个文件就要写十行RW 扇区数 FLAT win10-f00X.vmdk 0。这十行的扇区数加起来必须正好等于原磁盘的总扇区数差一个扇区 VMware 都可能报错或者识别成错误容量。这里有个经验值可以参考大部分 2GB 切片的 flat 文件大小是 2097152000 字节左右除 512 是 4096000 扇区写进描述符里用这个数字基本不会错。但最保险的还是实测因为有些工具生成的切片会带一点点差异。3.2 一份可直接抄的描述符模板Workstation 场景假设场景是这样的目录里有win10-flat.vmdk大小 21474836480 字节扇区数 41943040你需要在同目录下新建一个win10.vmdk文本文件内容如下# Disk DescriptorFile version1 encodingUTF-8 CIDfffffffe parentCIDffffffff createTypemonolithicFlat # Extent description RW 41943040 FLAT win10-flat.vmdk 0 # The Disk Data Base #DDB ddb.adapterType lsilogic ddb.geometry.cylinders 2610 ddb.geometry.heads 255 ddb.geometry.sectors 63 ddb.virtualHWVersion 17 ddb.uuid 60 00 C2 9d 3a 4f 8b 21-9c 6e 0d 44 12 8a 5f 71 ddb.longContentID a1b2c3d4e5f60718293a4b5c6d7e8f90逐行解释一下。CID是当前磁盘的内容标识独立磁盘没有快照随便写一个 8 位十六进制都行我习惯用 fffffffe但不要写 ffffffff那是给 parentCID 保留的。parentCIDffffffff表示我没有父盘独立磁盘就该这么写。createType要和实际文件结构匹配单文件用monolithicSparse描述符加 flat 用monolithicFlat多切片用twoGbMaxExtentFlat。ddb.geometry这三行是老 BIOS 时代留下的 CHS 参数现代虚拟机基本都用 LBA 寻址写个近似值就行公式是 柱面数 总扇区数 ÷ (255 × 63)。41943040 ÷ 16065 ≈ 2610.9取整写 2610 即可写 2611 也不会导致数据损坏因为它只是给老系统看的兼容信息不参与实际读写。ddb.uuid里那 16 个字节随便填合法十六进制就行全目录唯一最好实在懒得想用上一台机器的改一个字符也能跑起来。ddb.adapterType一定要和你 vmx 里的控制器一致vmx 写 lsilogic 这里就写 lsilogic写错会出现能识别磁盘但系统找不到硬盘的怪现象。3.3 快照链断裂时的取舍救数据还是救时间带快照的虚拟机磁盘结构是这样的win10.vmdk是基础盘描述符指向win10-flat.vmdkwin10-000001.vmdk是第一个快照的增量盘描述符里面parentCID指向基础盘的 CIDparentFileNameHint指向基础盘路径win10-000001-delta.vmdk才是增量的数据。整个链条一环扣一环CID 必须严丝合缝。如果你的 vmx 里挂的是win10-000001.vmdk报错也指向它那先别管它去看看基础盘win10.vmdk和win10-flat.vmdk是不是完好的。如果基础盘好的增量盘坏了最稳妥的做法是放弃快照把 vmx 里的 fileName 改回win10.vmdk虚拟机就能开起来代价是恢复到做快照之前的状态。快照里的数据能不能救可以试试手工修增量盘的描述符把 parentCID 和 parentFileNameHint 补对但这个操作成功率不算高尤其是链条断在中间层的时候。我的建议是生产数据和长期积累的测试环境优先保基础盘随手做的一次性快照直接放弃。曾经为了让一个三步快照链跑起来我把 CID 一层层还原折腾了三个小时结果开机后文件系统还是提示要 chkdsk因为中间某一步的增量数据本身就不完整。那次之后我的原则就变成——快照不是备份坏了就别救趁早回到基础盘。注意手工重建描述符之前把原始的描述符文件改名保留比如win10.vmdk.orig别直接覆盖。修不好可以立刻还原这个习惯救过我好几回。4. 官方工具能救的场合别急着当手工党4.1 vmware-vdiskmanager 的修复与检查Workstation 装完之后安装目录里有个vmware-vdiskmanager.exeLinux 版是vmware-vdiskmanager这东西专门管虚拟磁盘。遇到不是虚拟磁盘这种识别类错误先用它检查一遍# Windows 下在 Workstation 安装目录里执行 vmware-vdiskmanager.exe -e D:\VMs\win10\win10.vmdk # Linux 下 vmware-vdiskmanager -e /home/user/vms/win10/win10.vmdk-e是检查磁盘完整性的它会尝试解析描述符、核对 extent 文件、检查快照链能修一些小毛病。如果检查通过但开机还是报错可以试试-R参数重建描述符vmware-vdiskmanager -R D:\VMs\win10\win10.vmdk-R会尝试根据数据文件重新生成描述符。但要注意这个命令在有些版本上对monolithicFlat支持良好对快照链和稀疏格式就未必管用而且它执行的时候不会问你要不要覆盖所以前面说的备份一步都不能省。我的经验是能用官方工具解决的场景大概占三成多半是描述符轻微损坏、PID 和 CID 不匹配这种剩下七成还是得靠手工建描述符或者找回正确的文件组合。还有两个实用参数顺手记一下-x 60GB是用来扩容的-d是指定磁盘格式的配合-i可以从一个磁盘克隆出另一个并顺便转换成所需格式。遇到格式不兼容类的报错用-i转一次格式往往比手工捣鼓快得多。4.2 ESXi 侧 vmkfstools 的用法差异如果虚拟机跑在 ESXi 上工具就换成 vmkfstools 了这个命令只能在 ESXi Shell 或者 SSH 进去之后用。检查磁盘一致性vmkfstools -e /vmfs/volumes/datastore1/win10/win10.vmdk转换格式或者克隆修复vmkfstools -i /vmfs/volumes/datastore1/win10/win10.vmdk -d thin /vmfs/volumes/datastore1/win10-new/win10.vmdk-d thin是精简置备-d thick是厚置备-d zeroedthick是延迟置零的厚置备。出了问题最常用的其实是-i克隆只要原始 vmdk 还能被 vmkfstools 读出来克隆一遍就能生成一份结构规整的新磁盘接着把 vmx 里的文件名改过去就能开机。这个思路的好处是不动原始文件出问题最多浪费点存储空间。不过 ESXi 上有个坑要提醒如果你在 vCenter 里看到的是 ESXi 虚拟机但磁盘文件 timeout 或者连 -e 都报错那可能不是描述符的问题而是数据存储本身有故障比如存储掉线、快照文件被某个备份任务锁住。这时候先解决存储层面的事情别一味修磁盘文件。我遇到过一次折腾了半天描述符最后发现是 iSCSI 链路抖动存储重新挂载之后虚拟机自己就好了。5. 那些看起来像磁盘坏了其实是别的问题5.1 挂载、导入与格式转换踩的雷有一类指定的文件不是虚拟磁盘并不是虚拟机本身的问题而是你试图用不合适的方式去碰它。最常见的三种一是用 Workstation 的映射虚拟磁盘功能去挂载一块 ESXi 格式的磁盘二是从 VirtualBox、Hyper-V 导过来的镜像直接改名塞进虚拟机三是把某个分区备份工具生成的 img/raw 文件当成 vmdk 用。这三种情况文件本身没错错的是身份和用途需要的是转换而不是修复。转换思路也比较固定VirtualBox 的 vdi 用VBoxManage clonemedium转成 vmdkHyper-V 的 vhdx 一般先转成 vhd再用 qemu-img 转成 vmdk裸的 raw 镜像可以用qemu-img convert -f raw -O vmdk直接生成。这类转换工具生成的 vmdk 本身就是自包含的或是标准 flat 格式VMware 直接就能认不用手工写描述符。还有一类是名字惹的祸。目录名、文件名里带中文、空格、特殊符号或者拷贝时被网盘、同步软件加上了(1)后缀导致描述符里的 extent 行和实际文件名对不上。这种情况连重建都不用把文件名改回去、把后缀去掉问题就解决了。我现在的习惯是虚拟机目录只用英文、数字和下划线看着土但从来不因为这个出问题。5.2 网络适配器、虚拟化开关这类周边报错搜这个报错的时候你会发现旁边总会冒出一堆看着不相关的词虚拟网络适配器带感叹号、vmnet1 有黄色标记、虚拟机没有网络适配器、装 Linux 蓝屏、装 Windows 11 提示 boot 相关错误、WSL2 提示没有启用虚拟化。这些东西虽然和不是虚拟磁盘不是一回事但经常同框出现因为它们都指向同一个底层状态——虚拟化环境本身没配好。遇到这一类排查顺序应该是先宿主机、后虚拟机。Windows 上打开启用或关闭 Windows 功能确认虚拟机平台相关的组件是勾上的宿主机 BIOS 里确认 CPU 虚拟化是开着的这一步漏了的话虚拟机不是启动慢就是各种反常。虚拟网卡带感叹号多半是虚拟网络驱动没装好卸载网络适配器驱动再让 Workstation 重装一遍通常就能恢复。至于安装 Linux 时蓝屏或者进不去图形界面那是 guest 系统层面的问题跟磁盘文件是否损坏没有关系别把它和今天的主题搅在一起。我的经验是把问题分层宿主机虚拟化开关是一层VMware 主程序与驱动是一层虚拟机配置文件是一层guest 系统是另一层。报错提示在哪一层就先在哪一层找。很多新手把所有问题混在一起调最后改乱了配置反而把本来好的东西也搞崩了。6. 问题速查表与日常防坑习惯6.1 一表速查下面这张表是我这些年遇到过的指定的文件不是虚拟磁盘的完整对照按现象找方向比一上来就乱试快得多。现象最可能原因处理方向记事本打开 vmdk 是乱码打开的是数据文件找同名描述符缺失则手工重建vmdk 只有 0KB描述符被截断或没拷完从备份找回或按数据文件重建描述符里 extent 指向的文件不存在改过名、挪过目录改文件名或改描述符里的路径大小不匹配告警拷贝中断、数据文件不完整重新拷贝或核对扇区数挂 -000001.vmdk 报错基础盘正常快照链断裂改 vmx 挂回基础盘放弃快照从别处拷来的整机打不开路径、CID、格式不匹配用 vdiskmanager 检查、克隆转换导入 VirtualBox/Hyper-V 镜像格式本身不同用转换工具生成标准 vmdk数据存储偶发掉线后报错存储链路问题先修存储再验证磁盘这张表的关键不在于准而在于帮你把猜变成看。每次处理完我都会顺手在虚拟机目录里放一个 readme写清楚这次是什么原因、怎么修的下次再出问题五分钟就能定位。6.2 我踩过的坑和我现在的规矩第一个坑是直接删文件腾空间。早年硬盘紧张我看 -flat 文件占地方以为删了虚拟机还能按描述符恢复结果是数据全没了描述符还在报错就是这一句。这块教训让我明白描述符和数据文件是一体的删哪个都不行。第二个坑是用错工具拷大文件。虚拟机目录动辄几百 GB用某些同步软件或者带断点续传的复制工具表面显示完成实际有几个文件没同步完整尤其是 -flat 这种大文件最容易出问题。我现在的规矩是虚拟机整机迁移一律用压缩包先打包再拷拷完必须校验文件大小和哈希绝不相信进度条到 100% 了。第三个坑是在虚拟机运行时操作文件。有人看着虚拟机里看不到那块盘就直接去宿主机上删文件或者在开机状态下挪目录报错自然跟着来。任何对虚拟机目录的改动都必须先彻底关机确认 VMware 进程不再占用文件再动手。Windows 上可以用资源监视器搜一下哪个进程锁着 vmdkLinux 上用 lsof确认干净了再操作。第四个坑是描述符里参数乱填。看着网上某个模板就照抄结果 createType 和实际文件结构不一致adapterType 和 vmx 对不上geometry 差得离谱能开机是运气开不了机是常态。我现在写描述符的固定流程是算扇区数、对 createType、对 adapterType、CID 和 parentCID 按是否有快照决定四个步骤逐个核对不跳步。最后分享一个我现在的备份习惯每台重要的虚拟机除了完整备份之外我都会单独把 vmx 和所有描述符文件不含 -flat复制到一个config-backup目录里整个目录也就几百 KB。这个习惯的价值在于哪天描述符真丢了可以照着备份里的内容重建连 UUID、几何参数都不用重新算。虚拟机这东西最贵的从来不是那几百 GB 的盘而是你花在上面配置好的环境和时间把配置文件看住了剩下的都好办。
