模块化不提供变量访问路径重映射能力，关键在于混淆工具对模块边界和跨模块引用的识别与保留策略；需按语义分层处理，精准保留spring、mybatis、json序列化、接口实现、模块系统等关键路径，并通过proguard模块感知配置、统一混淆输出、字符串同步处理等手段保障运行时正确性。

模块化本身不直接提供“变量访问路径重映射”能力，它只是组织代码的结构方式；真正实现混淆后仍能正确访问变量的关键，在于混淆工具（如 ProGuard、Allatori）对模块边界与跨模块引用的识别和保留策略。混淆过程会破坏原始命名，但必须确保反射调用、序列化、配置绑定、接口实现等运行时依赖的符号关系不被切断——这本质上是“有约束的重命名”，而非无序替换。

明确哪些访问路径必须保留

混淆不是全量改名，而是按语义分层处理。以下路径若被错误混淆，会导致 ClassNotFoundException、NoSuchMethodException 或运行时空指针：

• Spring Boot 中通过 @Autowired 注入的 Bean 类型名、构造函数参数名（尤其启用 spring.main.allow-bean-definition-overriding=true 时）
• MyBatis 的 resultMap 映射字段名、@Param 指定的参数别名
• JSON 序列化/反序列化使用的字段名（如 Jackson 的 @JsonProperty、Gson 的 @SerializedName）
• 模块间通过接口通信时，接口方法签名及其实现类的类名（需保持 implements XyzService 可解析）
• Java Module System（module-info.java）中 exports 和 requires 声明的包名，不能被混淆为非法模块名（如含数字开头或特殊字符）

利用 ProGuard 的模块感知配置做精准保留

ProGuard Maven Plugin 支持在 <configuration></configuration> 中指定模块级规则。例如，当 api-module 提供接口，impl-module 实现它，应在 impl-module 的 proguard.conf 中写：

• -keep interface com.example.api.** { *; } → 保留所有 API 接口定义，防止方法签名被破坏
• -keep class com.example.impl.** implements com.example.api.Service { *; } → 仅保留实现类中符合接口契约的方法，其余可混淆
• -keepclassmembers class * { @org.springframework.beans.factory.annotation.Autowired *; } → 保留所有被 @Autowired 标记的字段/方法名，保障 DI 正常工作
• -adaptresourcefilenames **.properties,**.yml → 若配置文件中硬编码了类名（如 task.class=com.example.TaskRunner），此选项让 ProGuard 同步更新资源文件中的类名引用

多模块项目中协调混淆输出与类路径一致性

模块化混淆容易出错的点在于：A 模块混淆后输出 a.jar，其中类名已重命名为 a.b.c.D，但 B 模块编译时仍引用旧名 com.example.Task，导致链接失败。解决方式是：

• 所有参与混淆的模块统一使用 <injar></injar> + <outjar></outjar> 输出，并确保下游模块的 <libs></libs> 配置指向混淆后的 JAR，而非原始 target/classes
• 在父 POM 中定义 <proguard.skip>true</proguard.skip>，仅对最终打包模块（如启动模块）启用混淆，其他模块以“已混淆依赖”形式参与构建
• 启用 -printmapping target/proguard.map，并在集成测试阶段用脚本校验：混淆后 impl-module 中的类是否仍在 api-module 的 exports 包路径下，且方法签名哈希值未变

字符串中的硬编码路径需同步处理

模块名、包路径、配置键等若出现在字符串字面量中（如 "com.example.service.UserService"），ProGuard 默认不处理。此时需配合字符串加密模块或手动加规则：

• 用 -stringpool 合并重复字符串，减少混淆后体积
• 对关键字符串添加 @KeepString 自定义注解，并在配置中写 -keep @interface KeepString + -keepclassmembers class * { @KeepString *; }
• 更彻底的做法：将所有跨模块访问路径抽取为常量接口（public interface ModulePaths { String USER_SERVICE = "a.b.c.D"; }），再用 -keep interface ModulePaths { public static final **; } 保留