迁移Jar至GitLab Maven仓库：deploy-file部署如何保留依赖关联？

你遇到的核心问题是：只用mvn deploy:deploy-file上传Jar文件时，没有同步上传包含依赖信息的POM文件，Maven无法识别该库的依赖关系，所以才会出现大量Class Not Found异常。下面是两种可行的解决方法：

方法1：上传原库的对应POM文件 #

如果你能拿到原库对应版本的pom.xml（最好是和你本地Jar包匹配的版本），直接在部署命令里添加-DpomFile参数指定这个POM文件即可：

mvn deploy:deploy-file \
              -DgroupId=com.github.dmurph \
              -DartifactId=jgoogleanalyticstracker \
              -Dversion=69f68caf8e \
              -Dpackaging=jar \
              -Dfile=jgoogleanalyticstracker-master-69f68caf8e-1.jar \
              -DpomFile=/path/to/original/pom.xml \
              -Durl=https://gitlab.com/api/v4/projects/{your-project-id}/packages/maven \
              -DrepositoryId=gitlab-maven

执行这个命令后，GitLab仓库会同时存储Jar包和对应的POM，后续引用该库时，Maven会自动读取POM里的依赖配置，拉取所需的依赖包。

方法2：手动编写POM文件上传 #

如果找不到原库的POM，就需要手动编写包含所有依赖的pom.xml：

1. 先创建一个基础的POM结构，填入和部署命令一致的groupId、artifactId、version：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.github.dmurph</groupId>
    <artifactId>jgoogleanalyticstracker</artifactId>
    <version>69f68caf8e</version>
    <packaging>jar</packaging>

    <!-- 这里添加原库的所有依赖，需要根据原库实际依赖填写 -->
    <dependencies>
        <!-- 示例：原库可能依赖commons-codec -->
        <dependency>
            <groupId>commons-codec</groupId>
            <artifactId>commons-codec</artifactId>
            <version>1.15</version>
        </dependency>
        <!-- 其他依赖继续添加到这里 -->
    </dependencies>
</project>

2. 同样用-DpomFile参数指向这个手动编写的POM，执行部署命令即可。

验证部署结果 #

部署完成后，进入GitLab的Maven仓库页面，找到这个包的详情，确认POM文件已经上传，并且里面的依赖节点正确。之后重新在项目中引用该包，Maven就会自动下载所需的依赖，Class Not Found的问题就能解决了。

内容的提问来源于stack exchange，提问作者Vojtěch