
使用 java.awt.robot 模拟键盘操作进行文件上传时,若未正确释放按键(尤其是 ctrl 键),会导致系统级按键卡住,引发全局键盘异常(如按 s 触发保存、按 f 触发查找等),必须重启才能恢复。
在您提供的 fileUploadFile() 方法中,核心问题在于 Ctrl 键被按下后未被释放。具体来看:
- 前半段执行了 Ctrl+V:先 keyPress(VK_CONTROL) 和 keyPress(VK_V),随后正确调用了 keyRelease(VK_CONTROL) 和 keyRelease(VK_V);
- 但后半段执行 Ctrl+Enter 时,仅调用了:
robot.keyPress(KeyEvent.VK_CONTROL); robot.keyPress(KeyEvent.VK_ENTER);
却完全缺失对应的 keyRelease() 调用 —— 这导致 Ctrl 键在操作系统层面持续处于“按下”状态,后续所有键盘输入都会被解释为快捷键组合(例如 S → Ctrl+S → 保存,F → Ctrl+F → 查找),造成键盘功能紊乱。
✅ 正确做法是:每个 keyPress() 都必须有且仅有一次匹配的 keyRelease(),尤其对修饰键(VK_CONTROL、VK_SHIFT、VK_ALT)更需严格配对。
以下是修复后的关键代码段(已修正逻辑、增强健壮性):
public void fileUploadFile(String fileName) {
logger.info("Inside - " + new Exception().getStackTrace()[0].getMethodName());
String filePath = System.getProperty("user.dir") + File.separator + "src" + File.separator + "test"
+ File.separator + "resources" + File.separator + fileName;
try {
javascriptExecutor.executeScript("arguments[0].click()", fileUploadPO.fileUpload());
Thread.sleep(3000);
Robot robot = new Robot();
StringSelection stringSelection = new StringSelection(filePath);
Clipboard clipboard = Toolkit.getDefaultToolkit().getSystemClipboard();
clipboard.setContents(stringSelection, null);
// Paste: Ctrl + V
robot.keyPress(KeyEvent.VK_CONTROL);
robot.keyPress(KeyEvent.VK_V);
robot.keyRelease(KeyEvent.VK_V); // ✅ 先释放 V
robot.keyRelease(KeyEvent.VK_CONTROL); // ✅ 再释放 Ctrl
Thread.sleep(500);
// Confirm dialog: Ctrl + Enter (注意:多数文件打开对话框实际响应的是 Enter,非 Ctrl+Enter)
// 更安全的做法是仅按 Enter;若确需 Ctrl+Enter,请确保释放
robot.keyPress(KeyEvent.VK_ENTER);
robot.keyRelease(KeyEvent.VK_ENTER);
// ⚠️ 补充:强制重置所有可能残留的修饰键(防御性编程)
resetModifierKeys(robot);
} catch (AWTException e) {
logger.error("Robot initialization failed", e);
throw new RuntimeException("Failed to initialize Robot", e);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
logger.error("Thread interrupted during file upload", e);
}
}
// 辅助方法:安全释放常见修饰键,避免残留
private void resetModifierKeys(Robot robot) throws InterruptedException {
int[] modifiers = {
KeyEvent.VK_CONTROL, KeyEvent.VK_SHIFT,
KeyEvent.VK_ALT, KeyEvent.VK_META
};
for (int key : modifiers) {
robot.keyRelease(key);
Thread.sleep(100);
}
}? 重要注意事项:
- 避免依赖 Ctrl+Enter 确认文件对话框:Windows/macOS 标准文件选择器通常只需按 Enter 或 Return 即可确认;Ctrl+Enter 并非常规行为,易引发兼容性问题。优先使用单 Enter。
- Thread.sleep() 不是可靠同步手段:建议结合显式等待(如 WebDriverWait 监听对话框出现)或封装为重试机制,而非硬编码休眠。
- Robot 是系统级操作,缺乏沙箱隔离:测试结束后建议调用 resetModifierKeys() 清理状态,提升稳定性。
- 生产环境慎用 Robot:该方案跨平台兼容性差(如 Linux 下文件对话框行为不同)、不可靠且难以调试。推荐优先采用 element.sendKeys(filePath)(对 直接设置路径)或基于 AutoIt/SikuliX 的专用方案。
通过严格按键配对与防御性重置,即可彻底解决键盘锁死问题,无需重启系统。










