问题说明
本文用于排查“ZSphere UI 网卡状态与底层系统状态不一致”类问题。
现象
- UI 硬件信息显示网卡 DOWN。
- 登录主机底层检查网卡链路状态为 UP。
适用环境
- 产品：ZVF
- 版本：4.10.7
- 组件：ZSphere
- 涉及对象：主机网络
- 场景：网络与交换机类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- 主机网络事实信息未刷新或采集缓存异常。
- 管理服务与主机 agent 状态同步延迟。
- 网卡重命名、bond 成员变化或驱动状态变化未被及时采集。
排查步骤
按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。
- 在主机底层确认 ip link、ethtool 等只读状态。
- 在 ZSphere CLI/API 中重新获取或刷新 HostNetworkFacts。
- 核对 UI 展示时间和主机 agent 最近一次同步时间。
- 如刷新后仍不一致，收集 hostUuid、网卡名、管理日志和 agent 日志。
处理方法
- 在确认底层网卡链路状态正常后，重新获取主机网络事实信息。
- 刷新完成后仍不一致时，保留主机和网卡信息，联系 ZStack 官方技术支持进一步确认同步异常原因。
验证方法
- 刷新后，UI 中的网卡状态应与主机底层实际链路状态一致。
- 确认管理服务和主机 agent 日志中未再出现相同的网络信息同步异常。