GitLab CI流水线执行Maven Goal失败求助：本地构建正常仅GitLab构建报错

你的情况很典型：本地构建完全正常，但GitLab流水线执行maven-clean-plugin:2.5时因无法连接Maven中央仓库、解析老旧依赖而失败。问题肯定出在GitLab Runner的环境配置上，下面是几个针对性的解决方案，按优先级排序：

1. 优先升级Maven Clean插件版本 #

错误里提到的maven-clean-plugin:2.5依赖的maven-plugin-api:2.0.6是非常老旧的版本（属于Maven 2.x时代），这类老包在中央仓库的访问稳定性差，且与现代Maven 3.x环境兼容性一般。直接升级到最新稳定版就能大概率解决问题：

在项目的pom.xml里修改插件配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-clean-plugin</artifactId>
            <!-- 替换为最新稳定版，比如3.3.2 -->
            <version>3.3.2</version>
        </plugin>
    </plugins>
</build>

新版本插件依赖的Maven API更适配当前主流环境，不会依赖那些难访问的老包。

2. 检查GitLab Runner的网络连通性 #

既然本地没问题，那大概率是GitLab Runner所在服务器无法正常访问Maven中央仓库：

• 登录到Runner所在机器，执行以下命令测试网络：

  curl -v https://repo.maven.apache.org/maven2/org/apache/maven/maven-plugin-api/2.0.6/maven-plugin-api-2.0.6.pom
  

  如果出现连接重置、超时等情况，说明网络存在防火墙或路由限制，需要排查调整。
• 如果是企业内网环境，需要给Maven配置代理。在项目根目录添加settings.xml，配置代理信息：

  <settings>
      <proxies>
          <proxy>
              <id>company-proxy</id>
              <active>true</active>
              <protocol>https</protocol>
              <host>你的代理主机</host>
              <port>你的代理端口</port>
              <!-- 若需认证，添加以下两行 -->
              <!-- <username>代理用户名</username> -->
              <!-- <password>代理密码</password> -->
          </proxy>
      </proxies>
  </settings>
  

  然后在GitLab CI脚本里执行Maven命令时加上-s settings.xml参数，指定使用这个配置文件。

3. 配置内部Maven仓库镜像 #

如果企业有自建的Maven仓库（比如Nexus、Artifactory），建议把中央仓库替换成内部镜像，既稳定又能避免外部网络问题。在settings.xml里添加镜像配置：

<settings>
    <mirrors>
        <mirror>
            <id>internal-mirror</id>
            <!-- 匹配所有中央仓库请求 -->
            <mirrorOf>central</mirrorOf>
            <url>http://你的内部仓库地址/maven2</url>
        </mirror>
    </mirrors>
</settings>

同样在CI脚本里用-s settings.xml指定这个配置。

4. 确认GitLab Runner的Maven版本 #

有时候Runner使用的Maven版本和本地不一致，也会引发老插件的兼容性问题。可以在CI脚本里先执行mvn -v查看版本，和本地做对比。如果Runner用的是Maven 3.8+，老版本的maven-clean-plugin:2.5可能存在兼容性问题，此时升级插件版本就更有必要了。

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