如何通过 module-info.java 配置实战解决 Maven 项目向模块化迁移时的变量重命名-java教程-PHP中文网

module-info.java仅声明模块依赖与包导出，不参与标识符重命名；真正需重命名时应修改包名、同步更新exports/opens、调整框架扫描配置及业务配置。

如何通过 module-info.java 配置实战解决 maven 项目向模块化迁移时的变量重命名

module-info.java 本身不参与变量重命名，也不处理 Java 源码中类、方法、字段等标识符的改名问题。它只定义 Java 9+ 模块系统的模块声明、依赖关系和包导出规则。

如果你在将传统 Maven 项目迁移到 Java 平台模块系统（JPMS）过程中，遇到“变量重命名”相关困扰，大概率是混淆了两类完全不同的事情：

✅ module-info.java 负责：模块名定义、requires 哪些模块、exports 哪些包、opens 哪些包给反射、uses/provides 服务机制等；
❌ 它不会也不应该用于重命名类名、字段名、方法名、Maven 的 artifactId 或 IDEA 中的模块名。

H3：明确目标：你真正想解决的是什么？

常见迁移场景中被误称为“变量重命名”的实际需求，通常指向以下三类问题：

模块名（module name）与 artifactId 不一致
例如：Maven 子模块目录叫 user-service，pom.xml 中 user-service，但你在 module-info.java 里写了 module com.example.userservice { ... } —— 这没问题，模块名可以独立于 artifactId，但需注意一致性便于维护。
包名（package name）与模块名不匹配引发警告或工具限制
JDK 推荐模块名与根包名保持一致（如 module com.example.user → 应含 package com.example.user;）。若你把包从 com.old.user 改成 com.new.user，那属于源码重构，不是 module-info.java 的职责。
IDEA/Maven 编译报错提示“package is empty”或“not in module graph”
这往往是因为：
- module-info.java 声明了模块，但对应包路径下没有 .java 文件；
- 或 src/main/java 下包结构没同步更新；
- 或 Maven 没启用模块编译（需配置 maven-compiler-plugin 的 release 或 source/target ≥ 9，且加 --enable-preview 等参数）。

H3：module-info.java 的正确配置要点（实战避坑）

一个典型、可工作的 module-info.java 示例：

module com.example.user {
    requires java.base;
    requires spring.core;
    requires jakarta.annotation;

    exports com.example.user.api;
    exports com.example.user.dto;

    opens com.example.user.config to spring.core;
    uses com.example.user.spi.UserServiceFactory;
}

关键说明：

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

模块名必须是合法的 Java 标识符：不能含 -、. 开头、数字开头，推荐用小写字母+点号分隔（如 com.example.user）；
requires 的模块名：对应 JDK 内置模块（java.sql）、JAR 的自动模块名（如 spring.core-6.1.0.jar → 默认模块名 spring.core），或你其他模块的显式模块名；
exports 的包必须真实存在，且路径必须与 src/main/java/com/example/user/api/ 等物理结构严格一致；
若使用 Spring、Hibernate 等框架，常需 opens 包给框架反射访问，否则运行时报 InaccessibleObjectException。

H3：配合模块化迁移的真正“重命名”操作清单

如果你确实需要调整名称（比如统一规范、解耦旧包），请按顺序执行以下步骤，而非动 module-info.java：

修改 Java 包名（如 com.old.service → com.new.service）
→ 在 IDEA 中右键包 → Refactor → Move Package，勾选 Search in comments and strings 和 Search for text occurrences，确保引用同步更新。
同步更新 module-info.java 中的 exports / opens / uses 行里的包名
→ 手动修改，或用 IDEA 全局替换（Ctrl+Shift+R），范围限定为 module-info.java 文件。
检查所有 @ComponentScan、@MapperScan、@EntityScan 等注解中的 basePackages 值
→ 例如 @ComponentScan("com.old.service") 必须改为 "com.new.service"。
更新 application.yml / application.properties 中的自定义配置前缀（如 app.service.timeout → app.newservice.timeout）
→ 属于业务配置层，和模块系统无关，但常被忽略。
清理本地 Maven 仓库中旧 SNAPSHOT 构建产物（尤其多模块间依赖）
→ 运行 mvn clean install -Dmaven.test.skip=true 重新安装全部模块，避免缓存导致 ClassNotFoundException。