macOS 10.15 Catalina下JavaFX应用全局菜单无响应问题求助

我身边好几个做JavaFX开发的朋友都在macOS 10.15 Catalina上碰到过这个糟心的问题——应用启动后全局菜单明明显示正常，但不管用鼠标点还是键盘快捷键都完全没反应，可应用本身运行一切正常，只要切到其他App再切回来，菜单就突然能用了。哪怕是像你贴的HelloFX这种用默认系统菜单的极简程序也逃不过，而在Mojave上就从来没出现过这个情况。

下面是几个经过开发者验证的可行解决办法：

1. 延迟请求窗口焦点（最稳妥的通用方案） #

这个问题本质是Catalina的窗口焦点机制和JavaFX菜单初始化的时机不匹配，给系统留一点渲染菜单的时间再请求焦点就能解决。修改你的start方法：

@Override
public void start(Stage stage) {
    String javaVersion = System.getProperty("java.version");
    String javafxVersion = System.getProperty("javafx.version");
    Label l = new Label("Hello, JavaFX " + javafxVersion + ", running on Java " + javaVersion + ".");
    Scene scene = new Scene(new StackPane(l), 640, 480);
    stage.setScene(scene);
    stage.show();
    
    // 延迟200ms再请求焦点，给Catalina的菜单系统足够的初始化时间
    new javafx.concurrent.Task<Void>() {
        @Override
        protected Void call() throws Exception {
            Thread.sleep(200);
            return null;
        }
    }.setOnSucceeded(event -> {
        stage.requestFocus();
        // 额外让根节点请求一次焦点，进一步确保菜单关联正常
        stage.getScene().getRoot().requestFocus();
    });
}

2. 强制刷新菜单系统（适配极端场景） #

如果延迟焦点的方法偶尔还是失效，可以尝试用JavaFX的内部工具类强制刷新菜单（注意这是非公开API，后续版本可能有变化，但目前OpenJFX 11-15版本都能用）：

import com.sun.javafx.tk.Toolkit;
import com.sun.javafx.tk.quantum.QuantumToolkit;

// 在stage.show()之后添加这段代码
Toolkit toolkit = Toolkit.getToolkit();
if (toolkit instanceof QuantumToolkit) {
    ((QuantumToolkit) toolkit).updateMenuBar();
}

3. 升级到最新版JavaFX（彻底根治） #

这个bug在OpenJFX 16及以后的版本里已经被官方修复了，如果你的项目允许升级依赖，直接把JavaFX版本升到最新稳定版，就能一劳永逸解决这个问题，不用写任何兼容代码。

问题根源 #

Catalina对macOS的窗口管理和菜单系统做了底层优化，而早期JavaFX版本（15及以下）的菜单初始化逻辑没有适配这个变化——应用启动时菜单虽然被渲染出来，但系统没正确把菜单的交互事件绑定到当前窗口，切换应用的操作会触发系统重新同步窗口与菜单的关联，所以菜单就恢复正常了。

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