如何在GitLab CI/CD流水线中引入Maven中央仓库外的外部库？

你遇到的核心问题是：所需依赖（NASA WorldWind、GDAL等）不在Maven中央仓库，导致流水线构建时依赖解析失败。以下是直接可落地的解决方案：

方案一：添加第三方公开Maven仓库 #

大部分非中央仓库的依赖，只要找到对应的公开仓库地址，添加到Maven配置中即可自动拉取。

1. 确定对应依赖的仓库地址 #

• NASA WorldWind官方仓库：https://maven.worldwind.arc.nasa.gov/repository/public/
• GDAL依赖仓库：https://repo.osgeo.org/repository/release/
• systems.uom快照依赖仓库：https://oss.sonatype.org/content/repositories/snapshots/

2. 配置仓库到项目配置中 #

方式A：修改项目pom.xml（推荐，项目级统一配置）

在项目根目录的pom.xml中添加仓库节点：

<repositories>
    <!-- NASA WorldWind仓库 -->
    <repository>
        <id>nasa-worldwind</id>
        <url>https://maven.worldwind.arc.nasa.gov/repository/public/</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>false</enabled></snapshots>
    </repository>
    <!-- OSGeo仓库（用于GDAL依赖） -->
    <repository>
        <id>osgeo-release</id>
        <url>https://repo.osgeo.org/repository/release/</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>false</enabled></snapshots>
    </repository>
    <!-- systems.uom快照仓库 -->
    <repository>
        <id>sonatype-snapshots</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        <releases><enabled>false</enabled></releases>
        <snapshots><enabled>true</enabled></snapshots>
    </repository>
</repositories>

<!-- 同步配置插件仓库，避免插件依赖找不到 -->
<pluginRepositories>
    <pluginRepository>
        <id>nasa-worldwind</id>
        <url>https://maven.worldwind.arc.nasa.gov/repository/public/</url>
    </pluginRepository>
    <pluginRepository>
        <id>osgeo-release</id>
        <url>https://repo.osgeo.org/repository/release/</url>
    </pluginRepository>
    <pluginRepository>
        <id>sonatype-snapshots</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
    </pluginRepository>
</pluginRepositories>

方式B：修改Maven settings.xml（全局级，适合CI环境统一配置）

如果你的流水线使用自定义Maven配置文件，在settings.xml中添加：

<settings>
    <profiles>
        <profile>
            <id>third-party-repos</id>
            <activation><activeByDefault>true</activeByDefault></activation>
            <repositories>
                <!-- 复制上述<repository>节点内容 -->
            </repositories>
        </profile>
    </profiles>
</settings>

方案二：手动安装本地依赖（针对无公开仓库的特殊依赖） #

如果某些依赖（如特定版本的GDAL）没有公开仓库，可手动下载jar包后安装到本地仓库，再在CI中处理：

1. 本地安装依赖示例 #

# 安装worldwind-2.2.1.jar
mvn install:install-file -Dfile=worldwind-2.2.1.jar -DgroupId=gov.nasa -DartifactId=worldwind -Dversion=2.2.1 -Dpackaging=jar

2. CI环境适配 #

• GitLab私有仓库方案：将jar包上传到项目的GitLab私有Maven仓库，在settings.xml中配置仓库访问凭证（使用项目DEPLOY_TOKEN）。
• 本地库目录方案：将jar包放到项目的lib目录，在pom.xml中添加本地仓库配置：

<repositories>
    <repository>
        <id>local-lib</id>
        <url>file://${project.basedir}/lib</url>
    </repository>
</repositories>

结合你的GitLab CI配置调整 #

1. 修正配置文件路径：你当前配置的MAVEN_SETTINGS_PATH: "workspace.xml"是笔误，Maven配置文件应为settings.xml，修改为项目中实际的配置文件路径。
2. 确保配置文件被提交：将修改后的pom.xml或settings.xml提交到代码仓库，确保CI能读取到。
3. 可选：流水线中手动安装依赖：如果需要在CI中直接安装本地jar，调整build阶段脚本：

build:
  before_script:
    - export PATH=$JAVA_HOME/bin:$PATH
    # 示例：手动安装lib目录下的worldwind依赖
    # - mvn install:install-file -Dfile=lib/worldwind-2.2.1.jar -DgroupId=gov.nasa -DartifactId=worldwind -Dversion=2.2.1 -Dpackaging=jar

验证步骤 #

1. 本地先执行mvn dependency:resolve，确认依赖能正常拉取。
2. 推送代码触发CI流水线，查看构建日志确认依赖解析错误消失。

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