JavaFX创建Robot对象抛出IllegalStateException的原因及解决咨询

开发JavaFX应用时，希望实现用户按下E键时，通过moveMouse()方法将鼠标指针移至屏幕中心，但运行时抛出IllegalStateException。尝试改用GlassRobot后，又出现IllegalAccessException，需排查操作错误及所需额外配置。

代码与错误 #

IllegalStateException 错误信息 #

说明：底部注释标注了Robot对象创建位置

Exception in thread "main" java.lang.reflect.InvocationTargetException
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)
    at java.base/sun.launcher.LauncherHelper$FXHelper.main(LauncherHelper.java:1082)
Caused by: java.lang.ExceptionInInitializerError
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:465)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(LauncherImpl.java:364)
    ... 5 more
Caused by: java.lang.IllegalStateException: This operation is permitted on the event thread only; currentThread = main
    at javafx.graphics/com.sun.glass.ui.Application.checkEventThread(Application.java:447)
    at javafx.graphics/javafx.scene.robot.Robot.<init>(Robot.java:70)
    at com.galactify.tiles/com.galactify.tiles.HelloApplication.<clinit>(HelloApplication.java:37) // 此处创建Robot对象
    ... 11 more

Scene Robot 声明 #

private static final Robot robot = new Robot() ;

GlassRobot 声明 #

private static final Robot robot = com.sun.glass.ui.Application.GetApplication().createRobot() ;

按键事件与鼠标移动方法 #

static void onKeyReleased(KeyEvent evt) {
        KeyCode key = evt.getCode() ;
        out.println(key + " is released") ;

        switch (key) {
            case F11 -> {
                stage.setFullScreen(!isFullscreen) ;
                isFullscreen = !isFullscreen ;
            }

            case C -> {
                stage.close() ;
                isClosed = true ;
            }

            case E -> setupInventory() ;

        }
    }

static void setupInventory() {
        robot.mouseMove((double) screenWidth / 2, (double) screenHeight / 2) ;
    }

1. IllegalStateException 原因与解决 #

原因：javafx.scene.robot.Robot 的实例必须在JavaFX应用线程（事件线程）中创建，而你将其声明为静态常量，在main线程（类初始化阶段）就完成了实例化，违反了线程限制。

解决方法：

• 将Robot的初始化移至JavaFX应用的start()方法中（该方法运行在事件线程）；
• 如果必须使用静态Robot，通过Platform.runLater()延迟初始化，确保在事件线程执行。

示例代码：

private static Robot robot;

@Override
public void start(Stage primaryStage) {
    // 初始化Robot到事件线程中
    robot = new Robot();
    // 其他初始化逻辑...
}

或者静态初始化方式：

private static Robot robot;

static {
    Platform.runLater(() -> {
        robot = new Robot();
    });
}

2. IllegalAccessException 原因与解决 #

原因：com.sun.glass.ui.Robot 属于JavaFX内部API，Java 9及以上的模块化系统默认禁止应用直接访问内部API，因此抛出访问权限异常。

解决方法：
在启动应用时添加VM参数，开放内部API的访问权限：

• 如果你的应用是未命名模块（非模块化项目），添加：

  --add-exports javafx.graphics/com.sun.glass.ui=ALL-UNNAMED
  

• 如果是模块化项目，将ALL-UNNAMED替换为你的模块名，例如：

  --add-exports javafx.graphics/com.sun.glass.ui=com.galactify.tiles
  

推荐方案 #

优先使用官方公开的javafx.scene.robot.Robot，而非内部API的GlassRobot，只需保证在事件线程初始化即可，无需额外开放内部API权限，更符合JavaFX的规范。

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