QFTest 验证 Java HMI 完全关闭方法

本文介绍在 QFTest 自动化测试中，可靠验证 Java HMI 应用是否真正终止的正确方法，包括避免通信干扰、使用内置终止节点、强制杀进程等实践策略，并指出常见误区与官方推荐方案。

本文介绍在 QFTest 自动化测试中，可靠验证 Java HMI 应用是否真正终止的正确方法，包括避免通信干扰、使用内置终止节点、强制杀进程等实践策略，并指出常见误区与官方推荐方案。

在 QFTest 中验证被测系统（SUT，即 Java HMI 应用）是否“已彻底关闭”，是一个看似简单却极易误判的关键检查点。许多用户（如问题中所述）尝试在 shutdown 阶段持续通过 rc.toSUT() 发送 socket 请求并捕获异常来推断进程死亡——这种做法存在根本性风险：QFTest 的 Java Agent 会维持与 JVM 的连接通道，即使应用逻辑已退出，Agent 仍可能保持部分存活状态，导致网络探测返回假阴性（看似连通）或假阳性（异常非因进程死亡引起）。因此，依赖运行时通信探测并非可靠依据。

✅ 正确做法应遵循“无干扰 + 显式控制”原则：

1. 避免 shutdown 过程中任何 rc.toSUT() 调用
   在应用关闭流程执行期间（例如点击“退出”按钮后），禁止调用任何与 SUT 的交互指令（如 rc.toSUT、rc.getComponent、rc.wait 等）。QFTest 的 Java Agent 会在 shutdown 时尝试优雅终止，若此时强行通信，不仅无法反映真实状态，还可能阻塞或干扰 JVM 的正常退出流程。

2. 优先使用 QFTest 内置的终止机制
   QFTest 提供了语义明确、行为可控的专用节点：

   • Terminate SUT 节点：触发标准 shutdown 流程，等待 JVM 完全退出；
   • Kill SUT 节点：强制终止进程（适用于挂起或无响应场景）；
     这两类节点均会主动清理 Agent 连接，并同步返回进程终止结果，是验证关闭状态的首选方式。

3. 补充验证：检查进程是否存在（推荐方案）
   若需 100% 确认进程已消失，可在 Terminate SUT 节点后添加自定义 Jython 步骤，不连接 SUT，而是查询操作系统级进程状态：

import subprocess
import time

# 假设你的 HMI 进程名包含 "hmi-app"（根据实际调整）
process_name = "hmi-app"
timeout = 30  # 最长等待秒数
check_interval = 1

for _ in range(timeout):
    try:
        # Windows 示例（使用 tasklist）
        result = subprocess.run(["tasklist", "/FI", f"imagename eq {process_name}*"], 
                              capture_output=True, text=True, check=True)
        if process_name.lower() not in result.stdout.lower():
            rc.setLocal("shutdownConfirmed", True)
            break
    except:
        # Linux/macOS 示例（使用 pgrep）
        # result = subprocess.run(["pgrep", "-f", process_name], 
        #                       capture_output=True, text=True)
        # if result.returncode != 0:
        #     rc.setLocal("shutdownConfirmed", True)
        #     break
        pass
    time.sleep(check_interval)
else:
    rc.setLocal("shutdownConfirmed", False)  # 超时未退出

⚠️ 注意事项：

• Terminate SUT 是默认推荐方式，适用于绝大多数标准 Swing/JavaFX 应用；
• Kill SUT 仅用于异常场景（如 UI 冻结、shutdown hook 卡死），因其跳过 JVM 清理逻辑，可能丢失日志或数据；
• 操作系统进程检查需适配平台（Windows/Linux/macOS），且确保测试机有足够权限执行进程查询命令；
• 切勿在 Terminate SUT 执行前或执行中插入 rc.toSUT() ——这是导致“HMI 未关闭”误报的最常见原因。

? 总结：验证 shutdown 成功的核心不是“能否通信”，而是“进程是否消失”。请始终优先使用 QFTest 原生终止节点，并辅以 OS 层进程检测。如遇复杂生命周期管理（如嵌入式 JVM、自定义 shutdown hook），建议参考官方示例 startStop.terminate（位于 \demo\carconfig\carconfig_en.qft），或直接联系 QF-Test 官方支持团队 获取针对性诊断——此类深度集成问题，社区平台难以提供有效协助。