java.awt.Robot输入:、/等特殊字符时抛出无效键码异常问题

问题根源分析 #

1. 无效键码异常的原因 #

java.awt.Robot依赖**虚拟键码（KeyEvent.VK_*）**模拟按键，而这些键码是基于美式键盘布局定义的。你的环境使用巴西ABNT2键盘，其键位与美式键盘差异显著：

• 美式键盘中:对应Shift+;（VK_SEMICOLON），但ABNT2键盘无单独;键，该字符需通过Shift+.输入，因此VK_SEMICOLON在ABNT2布局下属于无效键码
• 美式键盘中/对应VK_SLASH，但ABNT2键盘的/需通过Shift+7输入，VK_SLASH并非ABNT2布局的有效键码

以上两点直接导致调用keyPress时抛出IllegalArgumentException。

2. 跨布局健壮输入方案 #

最通用的解决方案是利用系统剪贴板复制粘贴，彻底绕过键盘布局限制，支持所有可打印字符：

import java.awt.*;
import java.awt.datatransfer.StringSelection;

private void typeText(Robot robot, String text) {
    // 将文本写入系统剪贴板
    StringSelection selection = new StringSelection(text);
    Toolkit.getDefaultToolkit().getSystemClipboard().setContents(selection, null);
    
    // 模拟Ctrl+V粘贴操作
    robot.keyPress(KeyEvent.VK_CONTROL);
    robot.keyPress(KeyEvent.VK_V);
    robot.keyRelease(KeyEvent.VK_V);
    robot.keyRelease(KeyEvent.VK_CONTROL);
    
    // 可选延迟，确保粘贴操作完成
    robot.delay(100);
}

使用示例：

Robot robot = new Robot();
String targetText = "https://example.com:8080/";
typeText(robot, targetText);

若需逐字符模拟键盘输入（例如要触发应用内的键盘事件监听），则需针对ABNT2布局修正键组合映射：

private void typeSpecialChar(Robot robot, char c) {
    try {
        switch (c) {
            case ':':
                // ABNT2布局：Shift + 句号
                robot.keyPress(KeyEvent.VK_SHIFT);
                robot.keyPress(KeyEvent.VK_PERIOD);
                robot.keyRelease(KeyEvent.VK_PERIOD);
                robot.keyRelease(KeyEvent.VK_SHIFT);
                break;
            case '/':
                // ABNT2布局：Shift + 数字7
                robot.keyPress(KeyEvent.VK_SHIFT);
                robot.keyPress(KeyEvent.VK_7);
                robot.keyRelease(KeyEvent.VK_7);
                robot.keyRelease(KeyEvent.VK_SHIFT);
                break;
            case '&':
                // ABNT2布局：Shift + 数字6
                robot.keyPress(KeyEvent.VK_SHIFT);
                robot.keyPress(KeyEvent.VK_6);
                robot.keyRelease(KeyEvent.VK_6);
                robot.keyRelease(KeyEvent.VK_SHIFT);
                break;
            default:
                System.err.println("Unsupported special character: " + c);
        }
        robot.delay(50); // 添加短延迟，确保按键事件被系统正确识别
    } catch (Exception e) {
        System.err.println("Error typing special character: " + c);
        e.printStackTrace();
    }
}

3. 布局特定问题的结论 #

是的，这完全是键盘布局特定问题。KeyEvent.VK_*常量的有效性与当前系统的键盘布局强绑定，美式键盘的键码映射在ABNT2等非美式布局下会失效，因此固定VK码的代码无法跨布局兼容。

内容的提问来源于stack exchange，提问作者JamesB