JavaFX构建Windows屏保实际运行加载错误主类，求排查思路

你手动运行屏保命令行C:\PROGRA~1\Project\PROJEC~1.SCR /s能正常调用WinScreensaverApp，但系统自动启动屏保时却跑了DisplayerApp，这种情况大概率是打包或系统关联环节出了问题，我整理了几个可能的原因和对应的排查步骤：

可能的诱因 #

• Windows注册表关联错误：系统安装屏保时，注册表中记录的屏保执行路径可能指向了DisplayerApp的可执行文件，而非你正确的屏保启动器。
• Gradle插件打包混淆：虽然配置了多个secondaryLaunchers，但JavaFX Packager插件在生成native包时，可能在.scr文件的主类绑定上出了差错，导致屏保文件实际关联的是DisplayerApp。
• 屏保文件注册逻辑问题：Windows调用屏保的机制可能没正确识别你的Project Screensaver启动器，反而误关联了同目录下的其他可执行文件。

具体排查步骤 #

1. 验证屏保文件的真实主类

   • 找到打包生成的Project Screensaver.scr（一般在build\javafx\native\Project目录），可以用反编译工具查看它绑定的主类；或者在WinScreensaverApp的main方法开头加一段日志（比如写入本地文件C:\temp\screensaver_log.txt，记录"WinScreensaverApp started at: " + new Date()），然后触发系统屏保，看日志是否生成——如果没生成，说明系统根本没调用这个类。

2. 检查Gradle打包日志与输出文件

   • 重新运行打包命令，仔细看Gradle的构建日志，搜索secondaryLaunchers相关内容，确认Project Screensaver对应的启动器是否正确生成，且.scr文件的配置指向了tech.project.project.WinScreensaverApp。
   • 对比build\javafx\native\Project下的各个启动器文件，比如Project Displayer.exe和Project Screensaver.scr，检查它们的属性或配置文件（如果有的话），确认主类配置没有混淆。

3. 核对Windows注册表设置

   • 打开注册表编辑器（regedit.exe），先看HKEY_CURRENT_USER\Control Panel\Desktop下的SCRNSAVE.EXE键值，确认它指向的是C:\PROGRA~1\Project\PROJEC~1.SCR，而不是DisplayerApp的可执行文件。
   • 另外，查看HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Screensavers\Project（如果存在），确认其中的Command键值是否正确指向你的屏保启动器。

4. 检查参数处理逻辑

   • Windows启动屏保时会自动传/s参数，虽然你手动运行正常，但可以检查代码中是否有全局的参数判断逻辑，比如有没有误把某个条件触发成启动DisplayerApp的情况？比如是否有参数解析错误，导致跳转到了错误的主类。

5. 尝试升级Gradle插件版本

   • 如果你用的是旧版Gradle JavaFX Packager插件，可能存在多启动器打包的bug，尝试升级到最新稳定版后重新打包测试，看是否能解决问题。

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