JavaFX开发：Pane内Button按钮可见但点击无响应问题

问题现象 #

开发简易JavaFX游戏时，向Pane容器中添加Button按钮后，按钮可见但鼠标悬浮、点击均无任何响应，状态与被禁用一致。
对应问题代码：

private class Game extends Parent  {
   public Game() {
            private Button newGameButton;
            private Scene secondScene;
            private Stage secondStage;
            private Pane pane;
            VBox menu = new VBox(15);
            VBox highScore = new VBox(15);

            menu.setTranslateX(280);
            menu.setTranslateY(250);

            highScore.setTranslateX(100);
            highScore.setTranslateY(200);

            try {
                onLoad();
            } catch (IOException e) {
                e.printStackTrace();
            }

            newGameButton = new MenuButtonView("New Game");
            newGameButton.setOnMouseClicked(event -> {
                pane = new Pane();
                secondScene = new Scene(pane, 800, 600);
                secondStage = new Stage();
                secondStage.setScene(secondScene);
                secondStage.show();

                scoreAndCrackView();
                mickeyView();
            });
 
    public void mickeyView(){
        private Button leftDownRedButton;
        leftDownRedButton = new Button();
        rightDownRedButton.setTranslateX(640);
        rightDownRedButton.setTranslateY(560);
        
        pane.getChildren().add(rightDownRedButton);
        leftDownRedButton.setOnAction(new EventHandler<ActionEvent>() {
            @Override public void handle(ActionEvent e) {
                System.out.println("Clicked");
            }
        });
    }

    public void scoreAndCrackView() {
        vertBox = new VBox();
        vertBox.setPrefSize(800, 100); // 故障点，原配置为 vertBox.setPrefSize(800, 600)
        vertBox.getChildren().addAll(scoreLabel,crackLabel);
        pane.getChildren().add(vertBox);
    }
}

故障根因 #

按钮被上层控件遮挡：scoreAndCrackView()方法中创建的VBox容器vertBox原先被设置为和场景等大的800*600尺寸，作为后添加到Pane的控件，它渲染在按钮上层，透明区域会拦截所有鼠标事件，导致点击无法传递到底层按钮，最终表现为按钮可见但无响应。

修复方式 #

将遮挡控件的尺寸调整为实际业务需要的大小，也就是把vertBox的prefSize从800*600改为800*100，修改后按钮即可正常响应点击操作。

开发避坑提示 #

• JavaFX容器内控件的渲染层级和添加顺序一致，后添加的控件会覆盖在先添加的控件上层
• 布局容器的尺寸不要设置为超出实际需求的大小，透明的上层控件会拦截鼠标事件，导致下层控件假死
• 排查同类遮挡问题时，可以临时给可疑控件设置不透明背景，快速定位遮挡源

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