GitLab CI中Maven依赖解析失败问题求助

先看一下你当前的.gitlab-ci.yml配置：

image: maven:3-jdk-9
variables:
  MAVEN_CLI_OPTS: "--batch-mode"
stages:
  - build
compile:
  stage: build
  script:
    - mvn $MAVEN_CLI_OPTS compile

你已经试过更换插件版本、镜像、添加settings.xml等方法但没解决，那咱们从几个容易忽略的角度再排查：

1. 先确认CI环境的网络连通性 #

GitLab Runner所在的环境可能有网络限制，导致无法访问Maven中央仓库或者私有仓库。你可以在script里加个测试命令，验证网络是否通畅：

compile:
  stage: build
  script:
    - curl -v https://repo.maven.apache.org/maven2  # 测试中央仓库连通性
    - mvn $MAVEN_CLI_OPTS compile

如果curl返回超时或者4xx/5xx错误，那就是网络问题——要么需要配置代理，要么联系管理员开放仓库地址的访问权限。

2. 给Maven仓库加上缓存 #

每次CI构建都是全新的Docker容器，重复拉取依赖不仅慢，还容易因为网络波动失败。给.gitlab-ci.yml加上缓存配置，复用本地仓库：

image: maven:3-jdk-9
variables:
  MAVEN_CLI_OPTS: "--batch-mode"
cache:
  paths:
    - ~/.m2/repository/
  key: "$CI_COMMIT_REF_SLUG-$CI_PROJECT_PATH_SLUG"  # 按分支和项目缓存，避免冲突
stages:
  - build
compile:
  stage: build
  script:
    - mvn $MAVEN_CLI_OPTS compile

如果后续依赖有更新，GitLab会自动更新缓存；要是遇到缓存污染，也可以在GitLab项目设置里手动清理缓存。

3. 启用详细日志定位具体失败点 #

默认的Maven日志太简略，根本看不到是哪个依赖出问题。加上-X参数打印 debug 日志，能帮你精准定位：

compile:
  stage: build
  script:
    - mvn $MAVEN_CLI_OPTS -X compile

看日志里的Downloading和Error行，就能知道是依赖版本不存在、仓库地址错了，还是认证失败。

4. 尝试更稳定的Maven+JDK镜像 #

你用的maven:3-jdk-9比较老了，JDK 9已经停止支持，部分新依赖可能兼容性有问题。试试换成更稳定的镜像，比如maven:3.8.6-jdk-11或者maven:3.9.6-jdk-17，这些版本的生态支持更完善：

image: maven:3.8.6-jdk-11

5. 确认settings.xml的正确引用 #

如果你在项目里加了自定义的settings.xml（比如配置私有仓库、代理），一定要在Maven命令里指定它，否则CI会用默认的配置：

compile:
  stage: build
  script:
    - mvn $MAVEN_CLI_OPTS -s ./settings.xml compile  # 假设settings.xml在项目根目录

另外，私有仓库的认证信息（用户名、密码）不要硬编码在settings.xml里，用GitLab的CI/CD变量存储，然后在settings.xml里引用，比如：

<servers>
  <server>
    <id>private-repo</id>
    <username>${env.REPO_USER}</username>
    <password>${env.REPO_PASS}</password>
  </server>
</servers>

然后在GitLab项目的Settings > CI/CD > Variables里添加REPO_USER和REPO_PASS。

对了，你更新里提到的“使用th”是不是打错了？如果是代理或者其他特定配置，可以补充细节，我再帮你针对性调整。

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