11 故障排查

先按可见症状定位问题。每次只改一个目标字段、通道或参数，修改后重新测试。

窗口句柄无效或目标程序重启

现象：测试提示窗口无效，或此前可用的配置突然找不到窗口。

1. 确认目标程序仍在运行。
2. 重新使用窗口准星拾取。
3. 核对标题、类名和进程。
4. 重新执行三项通道测试。

句柄是当前会话 HWND，目标程序重启后可能变化。详见拾取窗口与目标详情。

标题或类名不匹配

现象：编辑器本地运行可以直接使用已拾取句柄，但打包执行端或批量获取找不到窗口。

• 确认标题和类名至少保留一个有效匹配条件。
• 检查标题是否会随文档名、账号或状态变化。
• 重新拾取后比较新旧标题和类名。
• 打包执行端和多窗口批量获取依赖标题和类名，不要只依赖旧句柄。

截图黑屏、空白或窗口错误

1. 切回 前台并保持目标可见，建立基线。
2. 确认缩略预览与目标一致，而不只看 成功状态。
3. 需要后台时逐项测试后台高速、通用、现代和像素。
4. 目标重启或渲染状态改变后重新拾取并重测。

后台名称不保证最小化、遮挡或特殊渲染下可用。详见原生截图通道。

后台键盘或鼠标无效

1. 用前台通道确认目标、焦点和坐标正确。
2. 键盘后台快速依赖目标处理窗口消息；不支持时保留前台。
3. 鼠标先试后台快速，目标依赖系统光标位置时再试后台稳定。
4. 在无副作用位置分别重测，不要直接运行正式流程。

鼠标落点偏移

• 确认填写的是客户区坐标，不是屏幕坐标或窗口外框坐标。
• 用坐标准星重新拾取安全点；一次测试会移动到该点并点击，同时核对落点和点击响应。
• 目标内容布局、客户区大小或 Windows 显示环境变化后重新测试。
• 不要用编辑器界面缩放推算目标窗口坐标。

测试结果变成已过期

这是配置变更后的保护提示。目标、驱动、通道、DM 参数、凭据或测试输入变化后，旧结果不再代表当前配置。按截图、键盘、鼠标顺序重新测试。

VNC 无法连接或测试后断开

1. 核对项目中保存的 IP 和端口，端口必须在1..65535。
2. 确认目标 VNC 服务正在监听，并允许当前电脑连接。
3. 回到 VNC 面板重新选择 连接，连接成功后再分别测试。
4. 任一测试失败后连接会自动释放；不要继续使用已经过期的测试结果。
5. 抓抓或星链运行仍失败时，确认项目保存的 endpoint 与刚才测试的一致。

VNC 连接状态不保存，重新打开绑定窗口后需要再次连接。更多边界见VNC 虚拟机绑定。

项目目录不可写

1. 确认所选目录存在。
2. 确认当前 Windows 用户可以在其中新建和删除普通测试文件。
3. 避免系统受保护目录、只读介质和无权限的网络位置。
4. 修复权限后重新选择 保存路径。

切换根目录不会迁移旧项目，详见项目路径与自动保存截图。

界面缩放异常

先恢复100%并应用，再检查 Windows 显示缩放。若问题只在某个显示器出现，记录显示器缩放比例、窗口位置和发生溢出的界面。

DM 路径、凭据或绑定失败

• 确认dm.dll和DmReg.dll都是实际文件，架构和版本匹配。
• 确认注册码和附加码去除首尾空格后仍非空。
• 对照当前 DM 版本文档检查截图、键盘、鼠标、公共和模式参数。
• 从默认模式0和默认normal字段开始，只按第三方文档逐项修改。
• 需要目标前台时尝试 绑定前激活；需要初始化等待时在0..10000 ms内逐步增加延迟。
• 每次改动后重新完成三项测试。

不要把真实凭据贴入截图、日志或问题描述。DM 项目打包失败时另查项目打包与发布手册。

仍无法定位

记录以下无敏感信息的内容：当前驱动、通道名称、目标是否重启、测试状态、完整错误文字、截图源尺寸以及 Windows 显示缩放。不要记录注册码、附加码、真实账号、私有路径或业务画面。

---

上一页：通道测试 | 下一页：完整示例