在使用 JavaFX 的 jlink 进行打包时，如果遇到非模块化的依赖导致 “模块异常” 报错，可以按照以下步骤进行问题处理：
一、问题分析
- 模块系统要求：Java 的模块系统（Java Module System）对代码的模块化有严格要求。如果项目中存在非模块化的依赖，可能会导致模块解析错误，从而引发 “模块异常” 报错。
- 依赖不兼容：非模块化的依赖可能与模块化的项目结构不兼容，导致模块无法正确加载和解析依赖。
二、处理方法
- 模块化依赖：
- 检查项目中的依赖是否有模块化版本。如果可能，尽量使用模块化的依赖库，以确保与 Java 的模块系统兼容。
- 对于一些常用的库，可以查找其模块化的替代品或更新版本。
- 自动模块转换：
- Java 允许将非模块化的 JAR 包自动转换为模块（称为自动模块）。在运行 jlink 时，可以使用
--add-modules ALL-MODULE-PATH参数，将非模块化的依赖添加到模块路径中，并让 Java 自动将其转换为模块。 - 例如，如果有一个非模块化的依赖库
mylib.jar，可以在运行 jlink 时使用以下命令：jlink --add-modules ALL-MODULE-PATH --module-path mymodulepath --output myjlinkedapp --launcher myapp=com.example.Main，其中ALL-MODULE-PATH包括了非模块化的依赖库和模块化的项目模块。
- 手动模块描述符创建：
- 如果自动模块转换不能解决问题，可以手动为非模块化的依赖创建模块描述符（module-info.java）。这需要对依赖库的内部结构有一定的了解，并确定其依赖关系。
- 在模块描述符中，可以声明依赖的模块、导出的包以及提供的服务等。
- 例如，如果有一个非模块化的依赖库
mylib.jar，其中包含一个名为com.example.mylib的包，可以创建以下模块描述符：
module mylib { exports com.example.mylib; }
- 将模块描述符和非模块化的依赖库一起放在模块路径中，然后在项目的模块描述符中声明对该模块的依赖。
- 检查模块依赖关系：
- 确保项目的模块描述符正确声明了对其他模块的依赖关系。如果有依赖关系错误或缺失，可能会导致模块加载失败。
- 使用
jdeps工具可以分析项目的依赖关系，并帮助确定是否存在模块依赖问题。
- 清理和重新构建：
- 在进行问题处理后，清理项目的构建目录，并重新构建和打包项目。确保所有的依赖都正确加载和解析。
通过以上方法，可以解决 JavaFX jlink 遇到的非模块化依赖打包报错 “模块异常” 的问题。在处理过程中，需要仔细分析问题的原因，并根据具体情况选择合适的处理方法。同时，建议在项目开发中尽量使用模块化的设计和依赖，以提高项目的可维护性和可扩展性。
