java模块化系统不直接管理本地动态链接库，仍需手动加载；但要求模块导出native类所在包，并通过module-info.java协调服务初始化，推荐将库资源嵌入模块、启动时提取并system.load()加载。
Java 模块化系统（自 Java 9 引入，Java 25 进一步强化）本身不直接管理本地动态链接库（如 .dll、.so、.dylib）的依赖。模块系统只负责 Java 类和包的封装、导出与依赖声明，而 native 库属于 JVM 之外的运行时资源，需由开发者手动协调加载时机与路径。关键在于：**模块化不影响 native 加载逻辑，但会影响类加载顺序、可见性及启动配置方式**。
确保 native 类在模块中可访问且能被提前触发
若封装 native 方法的类（如 NativeBridge）位于命名模块中，需注意：
-
模块必须导出该类所在包，否则其他模块无法引用它（即使只是触发 static 块）；例如：
exports com.example.nativeapi; -
避免隐式加载：Spring 或其他框架可能延迟初始化该类，导致 native 库未及时加载。可在
ApplicationRunner中主动写NativeBridge.class.getName()强制类加载 - 模块路径（
--module-path）不影响java.library.path，后者仍需单独通过-Djava.library.path=...或System.setProperty设置
将 native 库作为模块资源打包并运行时提取
推荐做法是把 .so/.dll 放在模块的 src/main/resources/lib/ 下，启动时复制到临时目录再加载：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 利用
Class.getResourceAsStream("/lib/libmylib.so")读取资源流 - 写入
Files.createTempDirectory("native-libs").resolve("libmylib.so") - 调用
System.load(absolutePath.toString())—— 此方式绕过java.library.path限制，跨模块、跨环境更稳定 - 可在
static块中完成整套逻辑，并校验返回值或抛异常阻止后续启动
配合 module-info.java 的注意事项
模块声明文件不描述 native 依赖，但可间接支持健壮性：
- 若 native 初始化失败需快速失败，可定义一个服务接口（如
NativeInitializer），在module-info.java中用provides声明实现，由主模块uses它，在启动阶段统一调用ServiceLoader.load()触发初始化 - 避免在
requires中尝试“声明 native 依赖”——这无意义，JVM 不识别 - 模块图分析工具（如
jdeps --list-deps）无法检测 native 调用，需人工维护文档或构建时校验库存在性
多模块共用同一 native 库时的实践
当多个模块都要调用同一个 C 库时：
- 建议将 native 封装类（含
static块和所有native方法）放在一个独立模块（如com.example.nativebridge）中 - 其他业务模块
requires该模块，并通过其提供的 Java 接口间接使用功能，而非各自重复加载 - 确保该桥接模块的
static块只执行一次（JVM 级别），天然满足“一次加载、全局可用” - 若不同模块需不同版本库，应隔离为不同桥接模块，避免冲突
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
