在OS上终端搜索有信息，但是workspace的虚拟机和终端都没信息

# CloudOS 终端可查到，Workspace 搜不到终端 / 虚拟机；CloudOS 操作重启、下载日志失败

>
> 现象：CloudOS 云桌面‑终端页面按 IP 检索，能看到该终端 IP、终端名称；但 CloudOS 页面执行**重启终端、下载日志按钮报错 / 失败**；Workspace 管理界面，终端列表、虚拟化‑虚拟机列表，通过 IP 都检索不到这条记录。
> 根因：**CloudOS 底层数据库有终端记录，但 CloudOS 与 Workspace 之间 VOI/VDI 数据同步链路异常；终端元数据没有同步写入 Workspace 数据库**，两端数据不一致。CloudOS 直接读取底层存储 / 数据库能看到记录，但跨组件调用 Workspace 接口执行操作失败；Workspace 库无这条终端 / 虚机数据，页面检索为空H3C。

>
> 区分：不是终端离线，是**平台层元数据同步断裂**，单台终端偶发，多见于异常断电、数据库事务异常、版本补丁升级后、终端异常注销未走完流程。

## 排查步骤（按顺序执行）

### 1、确认两端对接与服务状态（SSH 登录 CloudOS Master 节点）

1）检查 Workspace 对接配置，确认 CloudOS 与 Workspace 对接参数、IP、密钥未改动，对接状态显示正常。
2）检查 CloudOS 与 Workspace 之间网络：端口放通，防火墙 / 安全组没有拦截两边内部通信端口。
3）检查 CloudOS 关键容器 / 服务状态，查看同步服务是否异常：

```
docker ps -a
```

重点关注 vdi‑*、terminal‑*相关容器，有无 Exited 异常退出；如有异常容器尝试重启对应业务容器。

>
> ⚠️不要随意全量重启所有容器，优先记录异常容器 ID。

### 2、确认终端实际状态

1. CloudOS 页面查看该终端的**MAC 地址**（关键唯一标识，不要只依赖 IP，IP 可变化）。
2. 在 Workspace 终端列表，改用**MAC 地址搜索**，不要用 IP 搜索，确认是否能检索到；
- 如果 MAC 也搜不到：确认数据**完全未同步到 Workspace 库**；
- 如果 MAC 可以搜到，IP 搜不到：属于终端上报 IP 更新同步失败。
3. 登录终端 SpaceOS 本地，`SpaceConfig`查看终端注册服务器地址、平台版本、终端自身 MAC。确认终端实际注册对象是否为当前这套 Workspace。

### 3、两种场景处理

#### 场景 A：终端当前实际在线可用，业务可以正常使用，仅管理平台数据不同步

1. 优先尝试：终端本地执行重启，正常注销再重新向平台注册，触发元数据重新同步。

>
> 如果终端不方便现场操作：CloudOS 页面重启按钮调用 Workspace 接口会失败，**不能在 CloudOS 页面操作重启 / 下发日志**。

2. 终端重启上线后等待 5‑10 分钟，观察 Workspace 终端列表是否自动刷新出该终端记录。
3. 仍然不同步：属于数据库残留脏记录。**不要直接手动修改底层数据库表**，需要联系 H3C 技术支持，使用平台内置工具做终端元数据重新同步 / 清理脏数据。

#### 场景 B：终端已经不在现场，物理离线，CloudOS 还残留这条旧记录

1. CloudOS 底层存在残留脏数据，但是 Workspace 无记录，此时 CloudOS 上的重启、下载日志接口调用 Workspace 全部返回失败。
2. 需要由技术支持登录后台，清理 CloudOS 侧这条僵死残留终端记录；不能直接页面删除（页面删除同样依赖跨平台调用 Workspace 接口，会报错失败）。

### 4、日志收集（提交工单必备）

登录 CloudOS 主节点，收集以下目录日志：

- `/var/log/vdi/` Workspace 对接同步日志H3C
- CloudOS 终端服务日志，重点检索该终端 MAC 关键字，看同步接口返回报错（404/500 / 调用超时）。

>
> 报错关键字：terminal sync、push terminal data、workspace api invoke failed。

## 重要风险提醒

1. **严禁直接修改 CloudOS、Workspace 底层数据库表**，手动改库会引发更多数据不一致、桌面池异常。
2. CloudOS 页面按钮 “重启终端、下载日志” 本质是调用 Workspace 的 API 接口；Workspace 库没有这条终端对象，接口直接返回失败，因此按钮操作报错。
3. 如果批量终端都出现这个现象，是集群同步服务故障；仅单台终端出现，是该终端的元数据脏记录问题。