UIS Workspace 云课堂课程删除失败、清理按钮报错完整排障方案

一、故障根本原因

1. 教室残留在线 / 自习 / 考试桌面：教室绑定过该课程，下课未自动回收学生虚拟机，后台残留运行 / 休眠桌面；
2. 后台卡死任务锁：之前清理、上课、发布镜像任务异常中断，数据库产生占用锁，前台清理按钮失效；
3. 课程镜像被桌面池 / 模板引用：课程底层镜像被其他桌面池、模板复用，未解除关联。

二、分步前台排查清理（优先操作，无需后台命令）

步骤 1：排查所有绑定该课程的教室，彻底清理桌面

1. 进入左侧【教室管理】，筛选全部教室，查看哪些教室选用了该课程；
2. 逐个进入教室页面：
   • 普通课堂：执行自习清理，输入 DELETE 确认，删除所有学生遗留桌面；
   • 考试课堂：切换【考试】标签，点击对应课程右侧清理，清空考试缓存桌面；
3. 确认所有教室不再选用此课程，编辑教室，移除该课程绑定。

步骤 2：虚拟化后台手动删除残留虚拟机

1. 进入【数据中心→虚拟化→虚拟机】，筛选虚拟机名称包含课程名；
2. 勾选所有关联虚拟机，点击批量删除，勾选「删除存储文件」、输入管理员密码强制销毁；
3. 刷新列表，确认无残留虚拟机。

步骤 3：解除镜像复用关联（镜像被其他业务引用）

1. 进入【镜像管理→课程镜像】，打开该课程镜像详情；
2. 查看「引用对象」，若存在桌面池、模板、其他课程：
   • 进入对应桌面池 / 模板，更换底层镜像，解除对当前课程镜像的依赖；
3. 无引用后再返回课程页面执行清理。

步骤 4：清理后台卡住的任务（清理按钮点击无响应 / 报错）

1. 页面右上角【任务中心】，查看是否存在运行 / 失败的清理、发布、删除任务；
2. 能取消的任务全部取消；无法取消的卡死任务，执行服务重启释放锁：
   登录 CVM 主控后台 SSH，重启 Workspace 核心服务：

三、前台全部清理无效，后台强制清理（终极方案）

风险提示：操作前记录课程 ID，避免误删其他业务，建议业务低峰操作

1. SSH 登录 UIS 主控 CVK/CVM 服务器；
2. 连接 Workspace 数据库，清除课程占用关联记录（官方标准清理语句）；
3. 先执行前台全部虚拟机、教室解绑，再执行数据库清理；
4. 清理完成后刷新页面，直接删除课程。

四、额外排查点（容易遗漏）

1. 终端在线占用：查看【终端管理】，确认无学生终端正在登录该课程桌面，全部下线终端；
2. 定时任务占用：教室是否配置定时上课 / 定时还原，关闭所有关联定时任务；
3. 存储空间不足：存储池容量满会导致清理虚拟机失败，扩容 / 删除无用镜像释放空间；
4. 浏览器缓存问题：切换无痕浏览器、清除缓存重试清理按钮。

五、标准操作流程总结

1. 全教室清理自习 / 考试桌面，移除教室课程绑定；
2. 虚拟化后台批量删除课程关联所有虚拟机；
3. 检查镜像引用，解除桌面池 / 模板依赖；
4. 任务中心取消阻塞任务，卡死则重启 uis-core 服务；
5. 全部占用清空后，再次点击课程【清理】，清理完成即可删除课程。

极简一句话总结