KVM虚拟机qemu-img扩容镜像后无法正常启动故障求助

qemu-img 2.1.3版本存在已知缺陷：对qcow2格式镜像执行离线扩容时，不会自动修正镜像内GPT分区表的末尾备份表头偏移，直接启动后系统会识别到分区表损坏，卡在根分区挂载阶段。此时内核已经完成早期加载、网卡驱动初始化完成，IP地址沿用之前的配置/未过期DHCP租约，所以外部可以ping通IP，但系统无法完成完整引导流程，SSH、控制台登录均不可用。
如果扩容前镜像存在快照、元数据预分配配置，该问题触发概率为100%。

• 连接虚拟机VNC/串口控制台，可观察到明确报错：Backup GPT table is corrupt、GPT partition entry array is not at the end of the disk，或直接进入grub rescue模式
• 宿主机执行镜像校验命令，可看到分区表损坏相关输出：

  qemu-img check vm1.img
  

• 第一步先做镜像全量备份，避免操作失误导致数据丢失：

  cp vm1.img vm1.img.bak.$(date +%Y%m%d)
  

• 宿主机安装离线镜像操作工具，修复GPT分区表偏移：

  apt update && apt install -y libguestfs-tools
  guestfish -a vm1.img run : sgdisk /dev/sda -e
  

  上述命令会自动将GPT备份表头重写到扩容后磁盘的正确末尾位置，修复分区表校验错误。
• 正常启动虚拟机，登录系统后完成分区和文件系统扩容：
  • 扩容系统分区（以根分区为/dev/sda1为例）：

    # Debian/Ubuntu系统先安装growpart工具
    apt install -y cloud-guest-utils
    growpart /dev/sda 1
    

  • 扩容对应文件系统：

    # ext4文件系统执行
    resize2fs /dev/sda1
    # xfs文件系统执行（根分区挂载路径为/）
    xfs_growfs /
    

• 执行df -h确认分区容量已正确识别，修复完成。

• 低于2.6版本的qemu-img不要直接给带快照的qcow2镜像执行扩容操作，会100%触发分区表损坏
• 每次执行磁盘扩容操作后，先通过sgdisk/parted工具修正分区表偏移，再启动虚拟机
• 扩容前必须做镜像备份，避免镜像损坏导致数据丢失

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