Files
dxdesigner-part-replacement/docs/testing/2026-10-21-windows-desktop-lifecycle.md
T

6.5 KiB
Raw Blame History

Windows 桌面生命周期:工单 #1 的继续排查

2026-10-21。此次没有修改生产替换流程、保护锁或发布包。

工单能证明什么

工单四次整批 BOM 导入的直接中断原因是 inventory_cleanup:受控 CAD、已知子进程退出,自有句柄关闭,但五秒后仍枚举到该私有桌面。它不能证明 Windows 因工程数量多而拒绝导入,也没有足够信息证明残留持有者是谁。BOM 行匹配失败是另外一类结果,详见 首轮诊断。

对照微软官方文档

  1. CloseDesktop 关闭一个打开的桌面句柄。成功不等于所有引用消失。调用进程的线程正在使用这个句柄,或它是初始桌面句柄时,关闭会失败。
  2. GetThreadDesktop 返回指定线程关联的桌面句柄;文档明确不要对该返回值调用 CloseDesktop。它与应用通过 OpenDesktop 自己打开的句柄归属不同。
  3. Thread Connection to a Desktop 说明线程的桌面连接、STARTUPINFO.lpDesktop 和继承句柄的关系。线程连接不要求存在可见窗口;不能仅凭窗口列表为空判断没有持有者。
  4. Terminating a Process 明确进程终止不会自动终止其创建的全部子进程。TerminateProcess 是异步请求,必须等待退出。现有实现已有 Job、等待与句柄关闭逻辑;本轮未直接把它认定为错误或移除检查。
  5. Traversing the Thread List 给出 Toolhelp 线程快照遍历方法。CreateToolhelp32Snapshot 要求关闭快照句柄。
  6. 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 桌面测试另行通过。

用户现场的持有者尚未查实,不能宣称私有桌面残留已经修好。此次交付是微软文档核对、排除实验和能在现场定位到进程/线程的独立诊断工具;没有删除保护锁、强杀不明进程或放宽准确性校验。