macOS下Eclipse运行JavaFX程序Stage窗口无法打开问题求助

• 排查系统权限问题
  • 打开系统设置→隐私与安全性，检查Eclipse、jdk-17.0.1.jdk对应的Java程序是否已授予屏幕录制、辅助功能、文件与文件夹权限，缺少任意权限都可能导致窗口渲染失败且无控制台报错
  • 如果是升级macOS大版本后出现该问题，可先删除原有权限条目，重新打开Eclipse触发授权请求后重新授予权限
• 排查平台适配启动参数问题
  • 确认VM参数中是否添加了macOS专属启动参数-XstartOnFirstThread，缺少该参数在部分macOS版本下会导致JavaFX主线程调度异常，仅加载进程不渲染窗口
  • 检查是否存在多屏幕/外接显示器配置，JavaFX 17在部分macOS版本下会默认将窗口渲染到当前未激活的外接显示器上，可先拔掉外接显示器重试，或在代码中强制指定Stage的初始位置为屏幕可视区域内，代码示例：

    stage.setX(0);
    stage.setY(0);
    stage.show();
    

• 排查缓存与配置冲突问题
  • 删除Eclipse的运行配置缓存：打开Run→Run Configurations，删除对应JavaFX程序的现有运行配置，重新新建配置项，重新填写VM参数、关联build path后重试
  • 清除Eclipse项目缓存：右键项目→Refresh，之后执行Project→Clean清理项目编译产物，重新编译后运行
  • 检查是否安装了版本不兼容的JavaFX相关Eclipse插件（如e(fx)clipse），可临时禁用该插件后重试
• 排查GPU渲染兼容问题
  • 在VM参数中添加-Dprism.forceGPU=false关闭硬件加速，部分Mac的显卡驱动和JavaFX 17的Prism渲染框架存在兼容问题，关闭硬件加速可强制走CPU渲染
  • 如果是M系列芯片的Mac，确认使用的是arm64版本的JDK和JavaFX SDK，混用x86_64版本的组件在Rosetta转译下会出现窗口渲染异常
• 最小化验证测试
  • 新建空白JavaFX HelloWorld项目，仅保留最基础的Stage创建逻辑，直接运行验证是否能弹出窗口，可排除原有项目的隐藏配置问题
  • 临时替换为内置JavaFX组件的JDK版本运行测试，可排除独立SDK的配置错误问题

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