问题说明

本文用于排查 ZCenter 资源同步失败问题，通过检查云环境连通性、同步任务、分布式锁和服务日志定位异常。

现象

• ZCenter 无法完成云环境资源同步。
• 同步任务执行失败或资源信息未更新。

适用环境

• 产品线：ZVF
• 组件：ZCenter
• 版本：5.1.0

可能原因

该现象可能与以下情况有关：

• ZCenter 与 ZSphere 或 VMware 管理节点之间的网络连接异常。
• 同步任务异常退出后，Redis 分布式锁未释放。
• Region 信息拉取连续重试失败。
• vm-server 服务出现与资源同步相关的错误。

排查步骤

1. 检查云环境连通性

• 检查项：确认 ZCenter 到 ZSphere 或 VMware 管理节点的网络可达。
• UI 路径：进入“平台管理 > 云环境管理”。
• 预期结果：云环境状态显示为有效。
• 异常处理：检查 ZCenter 与对应管理节点之间的网络连接。

2. 手动触发同步

• 接口：POST /api/portal/v4/cloud-account/SyncAccount
• 请求参数：{"uuid": "cloudAccountId"}
• 检查项：观察接口返回信息，确认同步任务是否可以正常触发。

3. 检查分布式锁

• 检查项：检查 Redis 中是否存在 {serviceName}:{cloudAccountId} key。
• 说明：资源同步使用 Redis 分布式锁避免并发执行。此前的同步任务异常退出且锁未释放时，新任务可能无法获取锁。

4. 查看服务日志

• 检查项：查看 vm-server 日志。
• 日志关键字：syncResource、cloudAccountId。
• 处理方式：根据日志中的具体错误继续定位异常环节。

5. 检查 Region 拉取结果

• 检查项：确认 Region 信息是否成功拉取。
• 说明：Region 信息拉取失败时会自动重试 3 次，重试间隔为 50 ms；全部失败后，该 Region 会被标记为异常，但不影响其他 Region。

补充信息

• 排查时记录受影响的云环境、cloudAccountId、异常发生时间和相关服务日志。