JavaFX鼠标移至2D元素时SubScene内3D立方体动画冻结问题咨询

问题根因 #

你遇到的3D立方体冻结问题，核心是违反了JavaFX的单线程UI操作规则：

• JavaFX所有场景图元素的属性修改、UI更新操作，必须在JavaFX应用线程（JavaFX Application Thread）上执行
• 你使用了java.util.Timer创建后台线程执行立方体位移修改，属于跨线程操作UI，本身就存在线程安全隐患。当鼠标移动到2D按钮上时，按钮的悬停交互会触发UI重绘调度，此时后台线程的非法UI修改会被场景图的线程校验机制阻塞，属性变更无法触发3D场景的重绘，就会出现立方体冻结的现象。

修复方案 #

推荐优先使用JavaFX原生动画工具实现，也可以对现有Timer逻辑做线程适配：

方案1：使用AnimationTimer替换Timer（最优解） #

AnimationTimer是JavaFX专门用于帧同步动画的工具，回调方法默认在JavaFX应用线程执行，和场景渲染节奏完全匹配，不会出现线程安全问题。

方案2：为TimerTask的UI操作增加线程调度 #

如果要保留Timer实现，需要把修改UI的逻辑包装到Platform.runLater()中，强制投递到JavaFX应用线程执行。

修复后完整代码（方案1实现） #

package application;

import javafx.animation.AnimationTimer;
import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.PerspectiveCamera;
import javafx.scene.Scene;
import javafx.scene.SceneAntialiasing;
import javafx.scene.SubScene;
import javafx.scene.control.Button;
import javafx.scene.input.KeyCombination;
import javafx.scene.layout.AnchorPane;
import javafx.scene.paint.Color;
import javafx.scene.shape.Box;
import javafx.scene.transform.Rotate;
import javafx.scene.transform.Translate;
import javafx.stage.Stage;

public class Main extends Application {
    public static Box b1 = new Box(5,5,5);
    private AnimationTimer animationTimer;

    @Override public void start(Stage primaryStage) {
        AnchorPane globalRoot = new AnchorPane();
        Scene scene = new Scene(globalRoot, 1366, 768, true);
        PerspectiveCamera camera = new PerspectiveCamera(true);
        Group root3D = new Group();
        SubScene sub = new SubScene(root3D,1366,768,false, SceneAntialiasing.BALANCED);
        camera.getTransforms().addAll(new Rotate(30, Rotate.X_AXIS), new Translate(0, 0, -80));
        sub.setCamera(camera);
        sub.setFill(Color.BLACK);
        globalRoot.getChildren().add(sub);
        root3D.getChildren().add(b1);
        globalRoot.getChildren().add(new Button("Just a button"));
        primaryStage.setFullScreen(true);
        primaryStage.setFullScreenExitHint("");
        primaryStage.setFullScreenExitKeyCombination(KeyCombination.NO_MATCH);
        primaryStage.setScene(scene);
        primaryStage.show();
        startAnimation();
    }

    public void startAnimation() {
        animationTimer = new AnimationTimer() {
            @Override
            public void handle(long now) {
                b1.setTranslateX(b1.getTranslateX()+0.1);
            }
        };
        animationTimer.start();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

若选择保留Timer实现，仅需修改startTimer方法逻辑，同时导入javafx.application.Platform包即可：

public static void startTimer() {
    timertask1 = new TimerTask() {
        @Override public void run() {
            Platform.runLater(() -> b1.setTranslateX(b1.getTranslateX()+0.1));
        }};
    timer.scheduleAtFixedRate(timertask1, 0, 10);
}

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