Launch4j配置JVM选项时修改JavaFX模块路径不生效如何解决

• 相对路径解析基准错误：JVM启动时解析--module-path的相对路径，是以进程当前工作目录为基准，而非exe可执行文件所在的目录。如果是通过快捷方式、第三方程序唤起、桌面双击启动，工作目录大概率和exe所在目录不一致，直接写lib会导致JVM找不到对应模块路径。
• 复制的lib目录文件缺失：多数人复制JavaFX依赖时仅拷贝了目录内的.jar模块包，遗漏了JavaFX SDK lib目录下和模块绑定的本地原生库（Windows平台为.dll后缀文件，比如javafx.media依赖的jfxmedia.dll、ffmpeg相关解码库等），这类原生库是JavaFX GUI、媒体播放功能运行的必须依赖，缺失就会导致模块加载失败。
• 路径配置存在格式/权限问题：如果复制后的lib路径包含中文、空格、特殊符号，没有用双引号完整包裹路径会导致参数解析截断；如果lib目录放在系统权限受控的路径下，运行身份没有目录读取权限，也会出现路径存在但JVM无法加载模块的问题。
• 版本不匹配：复制的lib目录对应的JavaFX版本和项目编译时依赖的JavaFX版本不一致，跨版本的模块签名、类结构存在差异，会触发模块加载校验失败。

• 校验lib目录完整性：将复制到应用目录的lib文件夹，和原可正常运行的SDK路径D:\tools\javafx-sdk-18.0.1\lib做全量文件比对，确保所有.jar包、.dll原生库文件全部复制完成，无文件损坏、大小为0的情况，版本号完全对应。
• 修正路径配置逻辑：不要直接硬编码相对路径lib，启动时先获取exe文件自身的所在目录，再拼接lib目录的绝对路径传入JVM参数。如果是用bat脚本启动Windows程序，直接使用%~dp0获取脚本所在目录，对应参数写为：
  --module-path="%~dp0lib" --add-modules=javafx.controls,javafx.fxml,javafx.media
  如果是用exe打包工具生成启动程序，在工具的JVM参数配置项中使用工具自带的变量获取exe所在目录拼接lib路径，避免依赖工作目录解析。
• 排查路径访问问题：将应用目录放在非系统受保护的普通用户路径下，确保运行程序的用户对lib目录及内部所有文件有读、执行权限；如果路径包含空格、特殊字符，必须用双引号将整个module-path路径包裹，避免参数解析截断。
• 快速验证方法：打开命令提示符，cd切换到exe所在的目录，再执行启动命令传入--module-path=lib参数，如果此时程序能正常启动，即可确认之前的故障是相对路径解析基准错误导致的。

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