如何在Bitbucket Pipeline中运行Maven 3.9.8 + Java 21？

可能的原因 #

官方maven:3-openjdk-21镜像的Maven版本大概率不是你需要的3.9.8，或者该镜像在Bitbucket Pipelines环境中存在拉取、兼容性问题，导致无法正常生效。

可行方案 #

方案一：基于OpenJDK21镜像手动安装指定版本Maven #

放弃直接使用Maven官方镜像，改用纯OpenJDK21镜像，在Pipeline脚本里手动安装Maven3.9.8，配置示例如下：

image: openjdk:21

pipelines:
  default:
    - step:
        script:
          # 下载Maven3.9.8安装包
          - wget https://dlcdn.apache.org/maven/maven-3/3.9.8/binaries/apache-maven-3.9.8-bin.tar.gz
          # 解压到系统目录
          - tar -xzf apache-maven-3.9.8-bin.tar.gz -C /usr/local
          # 配置环境变量
          - export M2_HOME=/usr/local/apache-maven-3.9.8
          - export PATH=$M2_HOME/bin:$PATH
          # 验证版本是否符合要求
          - java -version
          - mvn -version
          # 执行你的Maven构建命令
          - mvn clean install

方案二：构建自定义Docker镜像（长期更高效） #

如果需要频繁运行Pipeline，手动安装Maven会浪费时间，建议预先构建包含Java21和Maven3.9.8的自定义镜像：

1. 创建Dockerfile文件：

FROM openjdk:21
# 安装下载依赖
RUN apt-get update && apt-get install -y wget
# 下载并安装指定版本Maven
RUN wget https://dlcdn.apache.org/maven/maven-3/3.9.8/binaries/apache-maven-3.9.8-bin.tar.gz \
    && tar -xzf apache-maven-3.9.8-bin.tar.gz -C /usr/local \
    && rm apache-maven-3.9.8-bin.tar.gz
# 配置全局环境变量
ENV M2_HOME=/usr/local/apache-maven-3.9.8
ENV PATH=$M2_HOME/bin:$PATH
# 验证环境是否配置成功
RUN java -version && mvn -version

2. 构建镜像并推送到Docker Hub（或私有镜像仓库）：

docker build -t 你的镜像仓库用户名/maven3.9.8-openjdk21 .
docker push 你的镜像仓库用户名/maven3.9.8-openjdk21

3. 在Bitbucket Pipelines中使用自定义镜像：

image: 你的镜像仓库用户名/maven3.9.8-openjdk21

pipelines:
  default:
    - step:
        script:
          - mvn clean install

方案三：排查镜像拉取或版本问题 #

如果怀疑是镜像拉取失败或版本不符，可先添加调试步骤确认问题：

image: maven:3-openjdk-21

pipelines:
  default:
    - step:
        script:
          - docker images
          - java -version
          - mvn -version

如果输出的Maven版本不是3.9.8，说明官方镜像确实不包含该版本，直接采用方案一或二即可。

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