maven-install-plugin无法加载本地依赖，Docker运行报错求助

核心问题梳理 #

1. Maven依赖标识不匹配：maven-install-plugin配置中的<artifactId>tetramap</artifactId>与依赖配置中的<artifactId>tetraMap</artifactId>大小写不一致，Maven对groupId/artifactId大小写敏感，导致依赖安装与引用不对应。
2. 依赖未被打包进可执行JAR：三种引入方式中，要么依赖未正确安装到本地仓库，要么依赖未被包含在构建的JAR包中，导致Docker容器运行时出现NoClassDefFoundError。
3. Docker构建依赖本地环境：当前Dockerfile直接复制本地构建的JAR，若本地构建时依赖缺失，镜像运行必然报错。

分步解决方案 #

1. 统一Maven依赖标识 #

修正所有配置中的artifactId为统一大小写（示例统一为tetramap）：

• 修正maven-install-plugin配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-install-plugin</artifactId>
    <version>2.5.2</version>
    <executions>
        <execution>
            <id>tetramap</id>
            <phase>install</phase> <!-- 改为install阶段，确保构建时执行 -->
            <goals>
                <goal>install-file</goal>
            </goals>
            <configuration>
                <groupId>tetramap</groupId>
                <artifactId>tetramap</artifactId> <!-- 统一大小写 -->
                <version>1.0</version>
                <packaging>jar</packaging>
                <file>${project.basedir}/lib/tetraMap-1.0.jar</file>
            </configuration>
        </execution>
    </executions>
</plugin>

• 修正依赖配置：

<dependency>
    <groupId>tetramap</groupId>
    <artifactId>tetramap</artifactId> <!-- 与plugin配置统一 -->
    <version>1.0</version>
</dependency>

2. 确保本地依赖安装到位 #

执行以下命令手动安装依赖（或执行mvn clean install触发plugin执行）：

mvn install:install-file -DgroupId=tetramap -DartifactId=tetramap -Dversion=1.0 -Dpackaging=jar -Dfile=./lib/tetraMap-1.0.jar

执行后检查本地仓库路径~/.m2/repository/tetramap/tetramap/1.0/，确认存在tetramap-1.0.jar、tetramap-1.0.pom文件。

3. 构建包含所有依赖的可执行JAR #

对于Spring Boot项目，必须通过spring-boot-maven-plugin构建Fat JAR（包含所有依赖），添加以下插件配置：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>你的Spring Boot版本号</version>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

执行构建命令：

mvn clean package -DskipTests

4. 优化Docker构建流程（可选但推荐） #

使用多阶段构建，在Docker内部完成Maven构建，避免依赖本地环境：

# 第一阶段：构建JAR
FROM maven:3.8.6-openjdk-11 AS build
COPY src /usr/src/app/src
COPY pom.xml /usr/src/app
COPY lib /usr/src/app/lib  # 复制本地依赖到构建上下文
RUN mvn -f /usr/src/app clean package -DskipTests

# 第二阶段：运行容器
FROM openjdk:11-jdk-slim
COPY --from=build /usr/src/app/target/*.jar tetraweb.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/tetraweb.jar"]

这种方式无需依赖本地.m2仓库，构建结果更可靠。

其他引入方式的问题说明 #

• System Scope方式：默认不会将依赖打包进Fat JAR，需额外配置spring-boot-maven-plugin的<includeSystemScope>true</includeSystemScope>，但该方式依赖本地路径，移植性差，不推荐。
• 本地文件仓库方式：需将本地依赖按Maven仓库结构存放（如lib/tetramap/tetramap/1.0/tetramap-1.0.jar），且Docker构建时需将整个lib目录复制到镜像中，配置复杂，不如install-plugin方式可靠。

内容的提问来源于stack exchange，提问作者Алексей Жуков