6.5 KiB
Windows 桌面生命周期:工单 #1 的继续排查
2026-10-21。此次没有修改生产替换流程、保护锁或发布包。
工单能证明什么
工单四次整批 BOM 导入的直接中断原因是 inventory_cleanup:受控 CAD、已知子进程退出,自有句柄关闭,但五秒后仍枚举到该私有桌面。它不能证明 Windows 因工程数量多而拒绝导入,也没有足够信息证明残留持有者是谁。BOM 行匹配失败是另外一类结果,详见 首轮诊断。
对照微软官方文档
- CloseDesktop 关闭一个打开的桌面句柄。成功不等于所有引用消失。调用进程的线程正在使用这个句柄,或它是初始桌面句柄时,关闭会失败。
- GetThreadDesktop 返回指定线程关联的桌面句柄;文档明确不要对该返回值调用
CloseDesktop。它与应用通过OpenDesktop自己打开的句柄归属不同。 - Thread Connection to a Desktop 说明线程的桌面连接、
STARTUPINFO.lpDesktop和继承句柄的关系。线程连接不要求存在可见窗口;不能仅凭窗口列表为空判断没有持有者。 - Terminating a Process 明确进程终止不会自动终止其创建的全部子进程。TerminateProcess 是异步请求,必须等待退出。现有实现已有 Job、等待与句柄关闭逻辑;本轮未直接把它认定为错误或移除检查。
- Traversing the Thread List 给出 Toolhelp 线程快照遍历方法。CreateToolhelp32Snapshot 要求关闭快照句柄。
- CreateDesktop 说明桌面堆限制。工单已有日志没有桌面创建失败或内存不足的证据,因此本轮没有改注册表的
SharedSection、全局资源配额或超时常量。
这些接口没有提供“按桌面名称强制删除全部引用”的安全操作。不能把关闭自己的句柄解释成强行删除其他进程持有的桌面。
原生受控实验
实验仅使用临时 Python 进程和 dx-doc-* 桌面,不打开真实工程。
| 实验 | 结果 |
|---|---|
| 无额外引用,GUI 进程正常退出 | 进程清理后桌面立即消失 |
| 额外持有已退出进程的内核句柄 | 桌面正常释放,不能将进程句柄残留直接当作本案根因 |
| 额外持有已退出线程的内核句柄 | 桌面正常释放 |
| 子进程线程仍连接私有桌面,但不创建窗口 | 复现相同保护现象;窗口清单为空,线程扫描能找到实际 PID/TID/程序路径 |
| 该外部线程的进程退出后 | 再次核验桌面正常释放 |
| 对当前线程正在使用的桌面调用 CloseDesktop | 真实返回 WinError 170;恢复原线程桌面后重试成功,pywin32 没有吞掉失败或丢失重试句柄 |
实际受控残留实验还发现该会话的 conhost.exe 线程。此结果只证明诊断能看到无窗口持有者,不能证明用户现场也是 conhost.exe 导致。
实验记录在 build/desktop-doc-research-20261021:retained-kernel-handles.json、close-api-contract.txt、retained-thread-session.json、retained-thread-diagnostic.json、released-after-owner-exit.json。原始机器日志未修改。
新增只读诊断工具
源码工具:diagnose_private_desktop.py。需要在发生问题的机器、桌面仍残留时运行,事后复制到另一台电脑的旧日志不能还原已消失的 Windows 资源。
在仓库根目录使用已安装项目依赖的 Python:
python tools/diagnose_private_desktop.py --record '实际失败会话/private-desktop.json' --output 'build/desktop-diagnostic.json'
也可以根据日志中的真实名称传入 --desktop dx-实际标识。同路径或硬链接形式的输出覆盖输入记录均被拒绝。
工具输出桌面是否仍被枚举、残留窗口、连接该桌面的线程 PID/TID/可执行程序路径,以及无法查询的线程错误统计。目标桌面查询句柄只在短生命周期子进程中打开;扫描子进程退出后再检查桌面存在性。借用的 GetThreadDesktop 句柄不关闭,自有进程查询句柄和快照关闭。不调用 SetThreadDesktop、SwitchDesktop、TerminateProcess,不关闭外部句柄。
实测 Windows 对另一进程的 GetThreadDesktop 查询,在仅打开 DESKTOP_READOBJECTS、READOBJECTS|ENUMERATE、READOBJECTS|WRITEOBJECTS 时仍返回访问拒绝,而打开拥有者 GENERIC_ALL 句柄后可以查询。因此仅在扫描子进程中请求该权限,仍只执行查询;权限不足会报错,不能当作“没有持有者”。
**工具的边界:**进程若只保留一个 OpenDesktop 句柄,却没有线程连接或窗口,线程/窗口扫描可能找不到它。空扫描不是释放证明;desktop_still_listed 仍独立报告。
这种情况下可使用微软官方 Sysinternals Handle,按其文档在管理员终端查询所有类型的句柄:
handle64.exe -a 'dx-实际标识'
这里只查询,不使用 -c 关闭外部句柄。该工具由现场人员按微软文档运行,本轮未下载执行、接受许可或更改系统配置。拿到真实持有 PID 后,才能区分自有程序的生命周期问题、外部进程引用和资源释放延迟,并针对已确认的所有者修复。
验证与当前结论
原生测试验证了无窗口线程识别、外部进程不受影响、输入桌面不切换、输入记录不修改、诊断不遗留句柄,以及无匹配线程时仍报告桌面存在。四项工具测试通过;已有 Windows 桌面测试另行通过。
用户现场的持有者尚未查实,不能宣称私有桌面残留已经修好。此次交付是微软文档核对、排除实验和能在现场定位到进程/线程的独立诊断工具;没有删除保护锁、强杀不明进程或放宽准确性校验。