JavaFX中MouseDragReleased事件未发送至目标节点问题排查

你碰到的这个问题其实是JavaFX全屏拖拽（full drag）机制里的一个常见小坑，我来帮你捋清楚原因和解决办法：

在JavaFX的fullDrag模式下，MouseDragReleased事件默认会发送给发起拖拽手势的节点的父容器（也就是你的棋子原来所在的Square），除非你在拖拽过程中，让鼠标当前悬停的Square明确“接收”拖拽事件。你的代码里只给Square注册了MouseDragReleased监听，但没有处理MouseDragOver事件并接受拖拽，所以JavaFX不知道要把释放事件发送到新的Square上。

另外，你在PieceImageView的mousePressed事件里提前设置了setMouseTransparent(true)，这虽然能让鼠标事件穿透到下方的Square，但结合未正确处理的拖拽事件传递逻辑，就进一步导致了释放事件“跑偏”到原节点的问题。

下面是具体的代码调整步骤：

1. 给Square添加MouseDragOver事件处理 #

修改Square类中的setMouseEventHandlers方法，新增MouseDragOver的处理逻辑，让当前悬停的Square接受拖拽：

private void setMouseEventHandlers() {
    // 新增：处理拖拽经过事件，告诉JavaFX这个Square可以作为拖拽目标
    this.setOnMouseDragOver(event -> {
        event.acceptTransferModes(TransferMode.ANY);
    });

    this.setOnMouseDragReleased(((MouseDragEvent event) -> {
        PieceImageView newPieceImageView = (PieceImageView) event.getGestureSource();
        if (ChessGame.movePiece(newPieceImageView.getRank(), newPieceImageView.getFile(), this.getRank(), this.getFile())) {
            // 移动合法性检查通过后，执行棋子移动
            Square oldSquare = (Square) newPieceImageView.getParent();
            oldSquare.getChildren().clear(); // 清空原Square的棋子

            newPieceImageView.setFile(this.getFile());
            newPieceImageView.setRank(this.getRank());
            // 重置棋子的拖拽偏移，避免位置错乱
            newPieceImageView.setTranslateX(0);
            newPieceImageView.setTranslateY(0);
            
            this.getChildren().clear();
            this.getChildren().add(newPieceImageView);
        }
    }));
}

2. 调整PieceImageView的鼠标透明设置逻辑 #

把鼠标透明的设置时机从mousePressed移到dragDetected，避免提前影响事件传递，同时确保拖拽结束后重置状态：

private void setMouseEventHandlers() {
    this.setOnDragDetected((MouseEvent event) -> {
        startDragX = event.getSceneX();
        startDragY = event.getSceneY();
        this.getParent().toFront();
        // 拖拽开始时设置鼠标透明，让下方Square能接收拖拽事件
        this.setMouseTransparent(true);
        this.startFullDrag();
    });

    this.setOnMouseDragged((MouseEvent event) -> {
        this.setTranslateX(event.getSceneX() - startDragX);
        this.setTranslateY(event.getSceneY() - startDragY);
    });

    this.setOnMouseReleased((MouseEvent event) -> {
        this.setMouseTransparent(false);
        // 重置偏移，防止下次拖拽起始位置错误
        this.setTranslateX(0);
        this.setTranslateY(0);
    });

    // 移除原来的mousePressed监听，不需要提前设置透明
}

关键细节说明 #

当你调用startFullDrag()后，JavaFX进入全屏拖拽模式，此时只有调用了event.acceptTransferModes()的节点才会成为拖拽事件（包括MouseDragReleased）的目标。通过在Square的MouseDragOver中接受拖拽，相当于告诉JavaFX：“这个节点是当前拖拽的有效目标”，这样当鼠标在这个节点上释放时，MouseDragReleased事件就会正确发送到该节点，而不是原来的Square。

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