应显式设置各子模块的archivesBaseName和group以确保唯一性：在build.gradle中设archivesBaseName为含路径语义的名称（如"common-model"），并按project.path映射group（如":lib:game:model"→group="com.example.lib.game"），同时在publishing块中正确定义MavenPublication。
子模块生成的 jar 文件名冲突，IDEA 或命令行里互相覆盖
Gradle 默认用 archivesBaseName + version 生成 jar 名，如果多个子模块没显式设置 archivesBaseName，它们都用默认值 project.name，而 project.name 又常取自目录名——这就导致 :common:model 和 :api:model 都打出 model-1.0.0.jar，后构建的会覆盖前一个。
解决办法不是“删掉一个”，而是让每个模块的输出 jar 名具备唯一性：
- 在每个子模块的
build.gradle中显式设置archivesBaseName = "common-model"或"api-model"，确保名字含路径语义 - 更稳妥的做法是基于完整项目路径动态生成：
archivesBaseName = "${rootProject.name}-${project.path.replace(':', '-')}" - 如果用了
java-library插件，还要注意jar任务可能被禁用（如 Kotlin 多平台项目），需先确认jar.enabled = true
publishToMavenLocal 时同名 artifact 冲突，mavenLocal() 里只留最后一个
当你对多个同名 jar 执行 ./gradlew publishToMavenLocal，Maven 本地仓库（~/.m2/repository/）按 groupId:artifactId:version 存储。如果两个模块都声明了 group = "com.example"、archivesBaseName = "model"，那它们最终都会试图写入 com/example/model/1.0.0/model-1.0.0.jar，后者必然覆盖前者。
这不是 Gradle 的 bug，而是 Maven 仓库规范本身不允许多个不同来源产出同一坐标 artifact：
- 必须保证每个模块的
group+archivesBaseName（即artifactId）组合全局唯一 - 推荐做法：用路径结构映射到 group，例如
:lib:game:model→group = "com.example.lib.game"，archivesBaseName = "model" - 避免所有模块共用同一个
group（如全设为"com.example"），否则光靠archivesBaseName很难保证不重
其他模块依赖时，project(':xxx') 正常，但发布后别人拉不到正确 jar
你本地用 compile project(':lib:content:model') 没问题，是因为 Gradle 直接引用源码编译结果；但一旦发布到 mavenLocal 或私服，外部项目通过 implementation 'com.example.lib.content:model:1.0.0' 拉取时，就完全依赖你在 publishing 块里声明的 groupId、artifactId 和 version ——和 project.path 没半点关系。
常见疏漏点：
- 忘了在
publishing块中显式配置publications，导致 Gradle 用默认 publication（可能只含 pom，不含 jar） - 用了
plugins { id 'maven-publish' }却没配publishing { publications { mavenJava(MavenPublication) { from components.java } } } - 子模块没 apply
java或java-library插件，components.java根本不存在，发布出来的就是空包
为什么重命名子项目目录还不管用？
很多人试过把 lib/content/model 改成 lib/content/content-model，以为能一劳永逸，结果发现 settings.gradle 里仍要写 include ':lib:content:model'，而 project.name 还是 "model" ——这说明真正起作用的是 settings.gradle 中的路径声明，不是文件夹名。
想彻底解耦，得同时改三处：
-
settings.gradle中的 include 路径，比如改为include ':lib:content:content-model' - 对应目录重命名，保持一致
- 子模块
build.gradle中显式设置archivesBaseName = "content-model"和group = "com.example.lib.content"
路径重复、名称重复、坐标重复，这三重叠加才是最隐蔽的坑。别只盯着 jar 文件名改，得从 project.path → archivesBaseName → publishing.publication.artifactId 串起来看。
