如何让Maven解析本地仓库依赖？本地Jar包编译失败排查

尝试构建Spring Boot项目时，Maven无法解析本地Jar依赖gov.nasa.drf:lib:1.0。已执行install-file命令且步骤成功，但compile阶段报错，提示在data-local本地仓库（路径file:///buildDir/repo）中找不到该artifact。

构建指令 #

mvn clean
mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=./repo/gov/nasa/drf/lib/lib-1.0.jar
mvn compile
mvn package

报错信息 #

Failed to execute goal on project auth: Could not resolve dependencies for project gov.nasa.drf:auth:jar:2.0: Could not find artifact gov.nasa.drf:lib:jar:1.0 in data-local (file:///buildDir/repo)

Dockerfile内容 #

FROM maven:3-openjdk-17 AS build

COPY ./src /buildDir/src
COPY ./repo /buildDir/repo
COPY pom.xml /buildDir/pom.xml
RUN mkdir ~/.m2

WORKDIR /buildDir
RUN mvn clean 
RUN mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=./repo/gov/nasa/drf/lib/lib-1.0.jar
RUN mvn compile 
RUN mvn package 

FROM openjdk:17-oracle
RUN mkdir -p /api/target
RUN mkdir -p /api/src/main
RUN mkdir /api/keys
RUN mkdir /api/logs
COPY src/main/resources /api/src/main/resources
COPY --from=build /buildDir/target /api/target
COPY pom.xml /api/pom.xml
WORKDIR /api
EXPOSE 8082
CMD ["java", "-jar", "/api/target/auth-2.0.jar"]

pom.xml关键配置 #

<repositories>
    <repository>
        <id>data-local</id>
        <name>data</name>
        <url>file://${project.basedir}/repo</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>gov.nasa.drf</groupId>
        <artifactId>lib</artifactId>
        <version>1.0</version>
    </dependency>
    <!-- 其他依赖省略 -->
</dependencies>

原因分析 #

install-file默认将Jar安装到Maven默认本地仓库（~/.m2/repository），但pom.xml中配置了从file://${project.basedir}/repo仓库查找依赖，该目录仅存放Jar文件，缺少Maven识别所需的元数据文件（如pom.xml、maven-metadata.xml），因此无法解析依赖。

解决办法 #

方法1：将Jar安装到指定的本地仓库（repo目录） #

修改install-file命令，显式指定依赖坐标及目标仓库路径，让Maven自动生成元数据文件并放入repo目录的规范结构中：

mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file \
-Dfile=./repo/gov/nasa/drf/lib/lib-1.0.jar \
-DgroupId=gov.nasa.drf \
-DartifactId=lib \
-Dversion=1.0 \
-Dpackaging=jar \
-DlocalRepositoryPath=./repo

同步修改Dockerfile中对应的RUN命令即可，执行后repo目录会生成符合Maven仓库规范的结构，Maven就能从data-local仓库找到依赖。

方法2：移除自定义仓库配置，使用默认本地仓库 #

删除pom.xml中的<repositories>节点，Maven会自动从默认本地仓库（~/.m2/repository）查找已安装的gov.nasa.drf:lib:1.0依赖，无需额外配置。

方法3：手动完善repo目录的仓库结构（不推荐） #

在repo/gov/nasa/drf/lib/下创建1.0子目录，将lib-1.0.jar移入该目录，同时手动创建lib-1.0.pom（修改项目pom.xml坐标）和maven-metadata.xml文件，此方法操作繁琐，易出错。

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