Java键盘事件检测异常：按下W/Esc键无响应问题求助

核心问题 #

1. 无焦点窗口导致无法接收键盘事件：Java的AWT键盘事件需要应用拥有一个获得焦点的可见窗口，否则系统不会把键盘事件传递给你的程序。
2. 主线程忙循环阻塞事件处理：main方法里的无限do-while循环占用了主线程全部CPU时间，导致AWT事件分发线程（负责处理键盘事件）无法执行KeyEventDispatcher的回调，按键状态永远不会更新。
3. 轮询逻辑重复触发输出：即使能检测到按键，当前逻辑会在按键按住期间持续打印信息，不符合“按下时输出一次提示”的预期。

修复后的代码 #

1. 调整Keyboard类（优化状态记录） #

package awd;

import java.awt.*;
import java.awt.event.KeyEvent;
import java.util.HashMap;
import java.util.Map;

public class Keyboard {
    private static final Map<Integer, Boolean> pressedKeys = new HashMap<>();
    private static final Map<Integer, Boolean> lastPressedState = new HashMap<>();

    static {
        KeyboardFocusManager.getCurrentKeyboardFocusManager().addKeyEventDispatcher(event -> {
            synchronized (Keyboard.class) {
                int keyCode = event.getKeyCode();
                if (event.getID() == KeyEvent.KEY_PRESSED) {
                    pressedKeys.put(keyCode, true);
                } else if (event.getID() == KeyEvent.KEY_RELEASED) {
                    pressedKeys.put(keyCode, false);
                }
                return false;
            }
        });
    }

    // 检测按键是否刚被按下（单次触发）
    public static boolean isKeyJustPressed(int keyCode) {
        synchronized (Keyboard.class) {
            boolean currentState = pressedKeys.getOrDefault(keyCode, false);
            boolean lastState = lastPressedState.getOrDefault(keyCode, false);
            lastPressedState.put(keyCode, currentState);
            return currentState && !lastState;
        }
    }

    // 检测按键是否处于按住状态
    public static boolean isKeyPressed(int keyCode) {
        synchronized (Keyboard.class) {
            return pressedKeys.getOrDefault(keyCode, false);
        }
    }
}

2. 修改Main类（添加窗口+优化循环） #

package awd;

import java.awt.*;
import java.awt.event.KeyEvent;

public class main {
    public static void main(String[] args) {
        // 创建可见窗口，让程序获得键盘焦点
        Frame frame = new Frame("Key Detector");
        frame.setSize(300, 200);
        frame.setVisible(true);
        // 关闭窗口时退出程序
        frame.addWindowListener(new java.awt.event.WindowAdapter() {
            public void windowClosing(java.awt.event.WindowEvent e) {
                System.exit(0);
            }
        });

        // 循环检测按键，每次循环让出CPU时间
        while (true) {
            // 检测W键刚被按下（仅触发一次）
            if (Keyboard.isKeyJustPressed(KeyEvent.VK_W)) {
                System.out.println("W is pressed!");
            }
            // 检测Esc键按下，终止程序
            if (Keyboard.isKeyPressed(KeyEvent.VK_ESCAPE)) {
                System.exit(0);
            }
            try {
                // 休眠10毫秒，给事件分发线程处理事件的机会
                Thread.sleep(10);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }
    }
}

关键修复点说明 #

• 添加可见窗口：创建Frame并设置可见，确保程序能获取键盘焦点，系统才会传递键盘事件。
• 线程休眠：Thread.sleep(10)让主线程让出CPU，AWT事件分发线程才能处理键盘事件、更新按键状态。
• 单次触发逻辑：新增isKeyJustPressed方法，仅在按键从“未按下”变为“按下”的瞬间返回true，避免重复打印。
• 同步处理：所有访问按键状态的方法都加了同步锁，避免多线程并发访问Map导致的线程安全问题。

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