Java 9应用中依赖Jar转自动模块命名无效的问题咨询

嘿，这个问题我之前帮团队排查过好几次，确实是Java 9模块系统迁移时的常见坑——自动模块的命名规则比很多人想的要严格，先给你拆解下你可能遗漏的命名细节，再分享几个实用的解决办法：

自动模块的名称默认是从Jar文件名推导而来，但不是直接照搬，有几个容易忽略的规则：

• 文件名的特殊字符处理：文件名里的-、_会被替换成.；如果文件名末尾带版本号（比如my-lib-2.1.0.jar），会自动截断掉最后一个-后面的版本部分，最终推导为my.lib。
• 必须符合Java标识符规则：模块名的每一段（.分隔的部分）都得是合法的Java标识符——不能以数字开头，不能包含除.外的特殊字符。比如2my-utils.jar推导出来的2my.utils就是无效的，因为开头是数字；my@lib.jar这种带特殊符号的也会直接报错。
• 优先级规则：如果Jar的META-INF/MANIFEST.MF里存在Automatic-Module-Name属性，会直接用这个属性的值作为模块名，完全忽略文件名推导。很多老Jar没有这个属性，才会依赖文件名，但一旦文件名不符合规则就会出问题。

1. 给依赖Jar添加Automatic-Module-Name属性（最推荐） #

这是最规范的解决方案，相当于给Jar手动指定合法的模块名：

• 步骤：用jar xf your-lib.jar解压Jar，找到META-INF/MANIFEST.MF，添加一行：

  Automatic-Module-Name: com.yourcompany.yourlib
  

  然后用jar cf your-lib.jar -M META-INF/MANIFEST.MF重新打包（记得把解压的其他文件也加回去）。
• 偷懒技巧：可以用jdeps --generate-module-info . your-lib.jar命令，它会自动分析Jar并生成建议的模块名和模块信息，直接用这个建议的名称就行。

2. 临时重命名Jar文件（应急方案） #

如果不想修改Jar文件，直接重命名让它符合规则就行。比如把2my-lib-1.0.jar改成my-lib-1.0.jar，推导出来的模块名就是my.lib，完全合法。但这个方案有个问题：如果你用Maven/Gradle这类构建工具，每次拉取依赖都会覆盖重命名后的Jar，所以只适合临时测试，不适合长期项目。

3. 将依赖转为显式模块（彻底根治） #

如果这个依赖是你自己维护的，或者能拿到源码，直接把它改成显式模块是长期最佳实践：

• 在Jar的根目录添加module-info.java，声明模块名和对外暴露的包：

  module com.yourcompany.yourlib {
      exports com.yourcompany.yourlib.api;
      // 声明依赖的其他模块，比如requires java.base;
  }
  

  重新编译打包成模块化Jar后，就再也不会有自动模块的命名问题了。

4. 用构建工具配置模块名（Maven/Gradle用户专属） #

如果你用Gradle 6+，可以直接在依赖中指定自动模块名，不用手动修改Jar：

dependencies {
    implementation(module("com.example:old-lib:1.0") {
        attributes {
            attribute(ModuleAttribute.MODULE_NAME, "com.example.oldlib")
        }
    })
}

Maven用户可以借助maven-dependency-plugin或者在pom.xml中通过dependencyManagement配合插件来实现类似效果，核心也是给依赖注入Automatic-Module-Name属性。

内容的提问来源于stack exchange，提问作者Lojza Ibg