JavaFX中Pane的onKeyPressed事件失效问题（Scene Builder构建GUI）

问题现象 #

你的JavaFX应用中，Pane的鼠标点击事件onMouseClicked能正常触发，但绑定在FXML中的按键按下事件onKeyPressed完全无响应，代码逻辑本身无语法错误。

核心原因 #

JavaFX的节点要接收键盘事件，必须获得焦点（focus）。而Pane控件默认不会主动请求焦点，也不支持焦点遍历（focus traversable），所以即使你在FXML中绑定了键盘事件处理方法，只要Pane没获得焦点，事件就无法传递到它身上。

解决方案（兼容FXML绑定方式） #

你不需要修改事件绑定的方式（依然保留FXML中的onKeyPressed="#onKeyPressed"配置），只需添加以下任一配置即可：

方案1：在FXML中设置Pane支持焦点遍历 #

直接在FXML的Pane标签里添加focusTraversable="true"属性，这样当你点击Pane时，它会自动获得焦点，从而能捕获键盘事件。修改后的FXML代码如下：

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.layout.Pane?>

<Pane fx:id="mainPane" 
      maxHeight="-Infinity" 
      maxWidth="-Infinity" 
      minHeight="-Infinity" 
      minWidth="-Infinity" 
      onKeyPressed="#onKeyPressed" 
      onMouseClicked="#onMouseClicked" 
      prefHeight="400.0" 
      prefWidth="600.0" 
      focusTraversable="true"
      xmlns="http://javafx.com/javafx/18" 
      xmlns:fx="http://javafx.com/fxml/1" 
      fx:controller="appdemo.ApplicationControllerClass" />

方案2：在控制器初始化时让Pane主动请求焦点 #

在控制器的initialize方法中调用requestFocus()，让窗口启动后Pane直接获得焦点，无需点击就能接收键盘事件：

@FXML
void initialize(){
    mainPane.requestFocus();
}

验证效果 #

修改完成后重新运行应用：

• 若用方案1：点击Pane区域后按下任意按键，控制台会打印Key pressed on pane!
• 若用方案2：窗口打开后直接按下任意按键，就能看到对应的日志输出

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