Gradle引用模块名与工件名不一致的依赖问题

你遇到的是Gradle默认依赖路径规则与旧Ant/Ivy发布的依赖结构不匹配的问题——路径中的模块名（api）和工件文件名（common-api）不一致，导致Gradle无法定位对应文件。不用急着重新发布依赖，有两种可行的解决方式：

方法1：在依赖中指定自定义工件 #

直接在依赖声明里明确指定实际的工件文件名，让Gradle去正确路径下查找对应的pom和jar：

implementation(group: 'com.group1', name: 'api', version: '1.0') {
    // 指定pom文件
    artifact {
        name = 'common-api'
        extension = 'pom'
        type = 'pom'
    }
    // 指定jar文件
    artifact {
        name = 'common-api'
        extension = 'jar'
        type = 'jar'
    }
}

配置后，Gradle会自动去/com/group1/api/1.0/路径下查找common-api-1.0.pom和common-api-1.0.jar，完全匹配你的仓库结构。

方法2：配置自定义仓库布局 #

如果这类非规范依赖数量较多，可以在仓库配置中自定义路径匹配规则，一次性适配所有同类依赖。由于原依赖是Ant/Ivy发布的，使用Ivy仓库布局会更贴合原有逻辑：

repositories {
    ivy {
        url "你的Artifactory仓库地址"
        layout "pattern", {
            // 定义工件路径模板：组织/模块/版本/工件名-版本.后缀
            artifact "[organisation]/[module]/[revision]/[artifact]-[revision].[ext]"
            // 若存在ivy描述文件，按同样规则匹配（无则可忽略）
            ivy "[organisation]/[module]/[revision]/ivy-[revision].xml"
        }
    }
}

之后引用依赖时，只需额外指定artifact参数即可：

implementation(group: 'com.group1', name: 'api', version: '1.0', artifact: 'common-api')

长期建议：重新发布规范依赖 #

上述方法可临时解决问题，但从长期维护角度看，更建议重新发布这些依赖，遵循Maven/Gradle的标准命名规范（模块名与工件名一致），避免后续新开发者重复踩坑，也能减少额外的配置复杂度。

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