Maven引入Gradle构建的仅POM依赖工具时构建失败求助

问题情况 #

我有个用Gradle构建的内部工具，它依赖一个只有POM文件的组件——这个POM只负责引入其他依赖，自身没有JAR包。工具在Gradle项目里能正常构建，但把它加到Maven项目里调用公司特定方法时，就算给依赖标了type="pom"，构建还是失败。

错误信息 #

[ERROR] Failed to execute goal on project : Could not resolve dependencies for project :jar:0.0.326: <com.pom.only.dependency>:jar:7.0 was not found in during a previous attempt. This failure was cached in the local repository and resolution is not reattempted until the update interval of has elapsed or updates are forced

已试操作 #

• 把工具打包成fat jar，问题依旧
• 移除工具依赖后，Maven项目可正常构建，确认是工具引入的依赖导致问题
• 手动添加仅POM的依赖并标记type="pom"，仍然报错
• 工具在Gradle项目中可正常引入构建

解决办法 #

1. 清理Maven本地仓库缓存 #

Maven会缓存依赖解析失败的结果，先清掉对应依赖的缓存：

• 找到本地Maven仓库中<com.pom.only.dependency>的对应目录（通常在~/.m2/repository/com/pom/only/dependency/7.0）
• 删除该目录下所有文件，重点删掉_remote.repositories和maven-metadata-*.xml
• 执行强制更新命令：

mvn clean install -U

2. 确保工具的POM正确声明pom-only依赖 #

如果你的Gradle工具是发布到仓库的，得确保它生成的POM里，对仅POM组件的依赖正确标记type="pom"（如果是BOM组件，还要加scope="import"）。Gradle里这么配置就行：

dependencies {
    // 若是BOM组件，用platform声明
    implementation platform('com.pom.only.dependency:7.0')
    // 普通聚合POM直接引入
    // implementation 'com.pom.only.dependency:7.0'
}

Gradle的platform对应Maven的import scope，能保证生成的POM里依赖类型为pom。

3. 在Maven项目中正确引入工具和依赖 #

要是工具的POM没声明正确，就得在Maven项目里手动处理：
如果是BOM类型的仅POM组件，通过<dependencyManagement>导入：

<dependencyManagement>
    <dependencies>
        <!-- 先导入仅POM的BOM组件 -->
        <dependency>
            <groupId>com.pom.only.dependency</groupId>
            <artifactId>xxx</artifactId>
            <version>7.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- 再引入内部工具 -->
        <dependency>
            <groupId>your.tool.group</groupId>
            <artifactId>your-tool</artifactId>
            <version>your-version</version>
        </dependency>
    </dependencies>
</dependencyManagement>

若是普通聚合POM，不用scope="import"，直接在<dependencies>里声明，再加<optional>true</optional>避免传递依赖问题：

<dependencies>
    <dependency>
        <groupId>com.pom.only.dependency</groupId>
        <artifactId>xxx</artifactId>
        <version>7.0</version>
        <type>pom</type>
        <optional>true</optional>
    </dependency>
    <dependency>
        <groupId>your.tool.group</groupId>
        <artifactId>your-tool</artifactId>
        <version>your-version</version>
    </dependency>
</dependencies>

4. 检查公司仓库的组件配置 #

确认公司仓库中<com.pom.only.dependency>:7.0确实存在，且只有POM文件（无JAR包）。直接访问仓库URL查看该组件目录，确保只有xxx-7.0.pom，没有xxx-7.0.jar文件。

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