Java模块化系统通过模块名唯一性、包名隔离、独立ModuleLayer及接口契约实现版本安全隔离，禁止跨版本类传递与静态污染。
Java 模块化系统（JPMS）本身不直接支持“模块版本”作为一级概念，但可通过组合模块声明、类加载隔离与路径控制，实现等效的版本安全隔离——关键不是让 JVM 识别“v1.2”，而是让不同版本的模块在运行时互不可见、互不干扰。
用 module-info.java 锁死导出边界，切断跨版本可见性
同一功能的不同版本（如 com.example.cache.v1 和 com.example.cache.v2）必须声明为独立模块，且彼此不互相 requires，也不共用 exports 包名：
- ✅ 正确做法：v1 模块只 exports com.example.cache.api，v2 模块 exports com.example.cache2.api（包名不同）；或两者都 exports 同名接口包，但内部实现包（如 com.example.cache.internal）均不导出
- ❌ 错误做法：v1 和 v2 都 exports com.example.cache，且主模块同时 requires 二者 → 编译期报错“重复导出”或运行时模块图解析失败
- 模块名必须唯一（如 com.example.cache.impl.v1 和 com.example.cache.impl.v2），否则 JVM 无法区分，会拒绝加载第二个
通过 ModuleLayer 实现运行时多版本并存
当需要在同一 JVM 中同时使用 cache-v1 和 cache-v2（例如插件系统或灰度发布），不能依赖单个模块层，而应为每个版本创建独立 ModuleLayer：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 主应用层加载通用 API 模块（如 cache-api），由 AppClassLoader 加载
- v1 插件启动时，构建新 ModuleLayer，仅 resolve cache-impl-v1 及其专属依赖（不含 v2 的任何 JAR）
- v2 插件同理，启用另一个 ModuleLayer —— 两个 Layer 中的 CacheService 类虽全限定名相同，但因所属模块不同、类身份不同，静态变量、方法区数据完全隔离
- 调用方通过 ServiceLoader.load(CacheService.class) 获取实例时，需指定对应 Layer 的类加载上下文，避免自动 fallback 到错误版本
禁止跨版本类传递，用接口契约收口状态
即使模块版本隔离成功，若业务代码直接 new 出 v1 的 CacheConfig 实例并传给 v2 的方法，仍会触发 ClassCastException。必须统一走抽象层：
立即学习“Java免费学习笔记（深入）”；
- 所有版本模块都依赖同一个轻量接口模块（如 cache-api），该模块由系统类加载器加载，不带任何实现
- v1 模块在 module-info.java 中声明：provides CacheService with com.v1.impl.V1CacheService
- v2 模块声明：provides CacheService with com.v2.impl.V2CacheService
- 调用方只 uses CacheService，通过 ServiceLoader 或 DI 容器获取，永远不持有具体实现类引用
配合资源路径与配置加载实现变量级隔离
版本相关的配置、密钥、模板等敏感变量，不能放在公共 static final 常量中（易被内联污染），也不能硬编码在实现类里：
- 将配置文件按版本组织：/modules/cache-v1/config.yml、/modules/cache-v2/config.yml
- 每个 ModuleLayer 启动时，绑定专属 URLClassLoader，并设置 context class loader 为该 Layer 的类加载器
- 读取配置时用 getClass().getResourceAsStream("/config.yml")，确保加载的是当前模块路径下的资源，而非 classpath 全局资源
- 敏感字段（如加密密钥）一律禁用 public static final String，改用私有字段 + 运行时从 Vault 解密加载
