Jenkins搭配Docker Agent执行Maven构建时JAVA_HOME未定义问题

我使用以下声明式Jenkins流水线：

agent {
    docker {
        image 'myimage:latest'
        reuseNode true
    }
    steps {
        sh "mvn clean install"
    }
}

执行时触发错误：

The JAVA_HOME environment variable is not defined correctly

This environment variable is needed to run this program

NB: JAVA_HOME should point to a JDK not a JRE

同一个镜像在Jenkins环境外执行mvn clean install完全正常，问题应该出在Jenkins对Docker容器的处理逻辑上。希望找到原生解决方案，不依赖外部插件，请问有没有人遇到过类似问题？

使用的环境信息 #

• Java版本（容器内外部一致）：

$ java -version

openjdk version "1.8.0_302"
OpenJDK Runtime Environment (IcedTea 3.20.0) (Alpine 8.302.08-r1)
OpenJDK 64-Bit Server VM (build 25.302-b08, mixed mode)

• Maven版本（容器内执行）：

$ mvn -v

Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
Maven home: /usr/share/java/maven-3
Java version: 1.8.0_302, vendor: IcedTea, runtime: /usr/lib/jvm/java-1.8-openjdk/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "5.10.104-linuxkit", arch: "amd64", family: "unix"

• 构建myimage的Dockerfile：

FROM amd64/alpine:3.14
RUN apk update
RUN apk add --no-cache openjdk8
RUN apk add --no-cache maven

解决方案 #

问题根源在于Jenkins启动Docker容器时，不会自动继承容器内默认的环境变量配置逻辑，而Alpine的openjdk8包默认没有在全局环境中设置符合Maven要求的JAVA_HOME（默认探测的是JRE路径，不符合Maven需要JDK的要求）。

方案1：修改Dockerfile，全局设置JAVA_HOME

直接在Dockerfile中添加环境变量配置，指向JDK的根目录（注意不是JRE子目录）：

FROM amd64/alpine:3.14
RUN apk update
RUN apk add --no-cache openjdk8
RUN apk add --no-cache maven
# 设置JAVA_HOME为JDK根目录
ENV JAVA_HOME=/usr/lib/jvm/java-1.8-openjdk
ENV PATH=$JAVA_HOME/bin:$PATH

重新构建镜像后，Jenkins流水线执行时就能正确读取JAVA_HOME，无需额外配置。

方案2：在流水线步骤中临时设置环境变量

如果不想修改现有镜像，可以在执行Maven命令前，先在shell中手动设置JAVA_HOME：

agent {
    docker {
        image 'myimage:latest'
        reuseNode true
    }
    steps {
        sh '''
            export JAVA_HOME=/usr/lib/jvm/java-1.8-openjdk
            export PATH=$JAVA_HOME/bin:$PATH
            mvn clean install
        '''
    }
}

验证说明 #

两种方案都能确保Maven找到正确的JDK路径：

• 方案1属于镜像层面的持久化配置，后续所有使用该镜像的场景都能直接生效
• 方案2是流水线层面的临时配置，仅对当前流水线任务生效

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