问题说明

QGA 依赖 VirtIO Serial 通道。驱动未正确加载或存在迁移/P2V残留冲突时，即使 VMTools 安装程序完成，平台也可能无法建立通道并显示未安装。

现象

• VMTools 安装完成，UI 仍显示未安装。
• 设备管理器中 VirtIO Serial Driver、Balloon Driver 出现黄色感叹号。
• 驱动状态是区别于 VERSION 空、Defender 隔离和纯状态未刷新的关键证据。

适用环境

• ZSphere 4.10.25 Windows Guest 已验证。
• TIC-5001 的典型背景为迁移/P2V后的 Windows 驱动残留。

可能原因

先确认异常设备及错误码，再核对驱动提供商/版本和迁移背景。只有异常设备与 QGA 状态同时存在，才按本篇处理。

问题定性

• 类型：环境/驱动兼容问题。
• 已知问题：是，TIC-6202 Closed/Done；参考 TIC-5001 Closed/Won't Do。
• 根因：Windows VirtIO Serial/Balloon 驱动异常或迁移残留冲突，QGA 通道无法正常工作。
• 影响版本：TIC-6202 已验证 ZSphere 4.10.25；不是已证明的全版本缺陷。
• 置信度：高，前提是设备错误码与通道异常同时成立。

排查步骤

检查一：枚举异常设备

• 只读 PowerShell：

  Get-PnpDevice -PresentOnly | Where-Object { $_.Status -ne 'OK' } |
    Format-Table Status,Class,FriendlyName,InstanceId -Auto

• 输出包含 VirtIO Serial/Balloon：继续检查错误码和驱动。
• 没有相关异常：返回 KB-100553 选择其他分支。

检查二：读取设备错误和驱动版本

• 只读 PowerShell：

  Get-CimInstance Win32_PnPEntity |
    Where-Object { $_.Name -match 'VirtIO|Balloon|Serial' } |
    Select-Object Name,Status,ConfigManagerErrorCode,PNPDeviceID
  Get-CimInstance Win32_PnPSignedDriver |
    Where-Object { $_.DeviceName -match 'VirtIO|Balloon|Serial' } |
    Select-Object DeviceName,DriverProviderName,DriverVersion,DriverDate

• ErrorCode 非 0 且驱动版本异常/残留：驱动链路证据充分。
• ErrorCode 为 0：黄色标识可能已恢复或截图过期，先刷新证据，不能直接更新驱动。

检查三：核对 QGA 服务

• 只读 PowerShell：

  Get-Service | Where-Object { $_.Name -match 'qemu|guest' } |
    Format-Table Name,Status,StartType -Auto

• 服务存在但 VirtIO Serial 异常、平台通道不可用：符合本篇因果链。
• 服务不存在或安装目录缺失：可能是安装不完整，不应归因驱动冲突。

处理建议

维护窗口内由 Windows 管理员备份/创建系统还原点，使用与目标 Windows 和 ZSphere VMTools 匹配的 VirtIO 驱动更新异常设备，然后按批准计划重启 Guest。若更新失败，回滚驱动或还原快照。重启后复核设备 ErrorCode=0、QGA 服务和页面状态。

长期方案

迁移/P2V前清理不兼容驱动，建立 Windows 版本与 VirtIO 驱动矩阵，并在 VMTools 安装后自动检查关键设备状态。

补充信息

升级人工条件

• 不确定驱动包与 Windows 版本是否匹配。
• 生产 Guest 不能重启。
• 驱动恢复后页面仍未安装。
• 存在代码签名、蓝屏或安全软件告警。

需要收集的信息

ZSphere/Windows版本、是否迁移/P2V、设备管理器截图、设备错误码、驱动提供商/版本/日期、QGA服务状态和VMTools安装日志。

相关问题

• TIC-6202，Closed/Done。
• TIC-5001，Closed/Won't Do。
• Jira 状态核验日期：2026-08-06。