GitLab CI配置Java项目编译时提示依赖包不存在如何解决

编译报错的核心原因非常明确：openjdk:8-jdk 基础镜像仅包含JDK原生标准类库，没有携带项目引用的Guice、Eclipse EMF等第三方依赖包；你当前执行的javac命令没有指定依赖类路径，编译器无法定位外部依赖的类，自然会抛出package不存在的错误。
之前在Eclipse中可以正常运行，是因为Eclipse本地构建路径已经提前配置好了所有依赖的存储位置，这套本地环境配置并没有同步到GitLab Runner的流水线构建环境中。

方案1：使用标准化Java构建工具（长期维护推荐） #

这是Java项目接入CI流水线的通用最优方案，可彻底解决环境不一致问题：

• 给项目添加Maven或Gradle构建配置，在配置文件中统一声明所有第三方依赖（包括你用到的Guice、EMF组件），同时配置打包规则，实现编译完成后自动输出目标jar包
• 调整.gitlab-ci.yml配置，直接调用构建工具命令完成全流程，不需要手动执行javac，参考配置如下：

build:
  stage: build
  only:
    - myBranch
  tags:
    - MyBuilder
  image: maven:3.8-openjdk-8 # 预置Maven+JDK8环境，无需额外安装组件
  script:
    - mvn clean package # 自动拉取依赖、编译代码、按规则打包jar
  artifacts: # 可选配置，将生成的jar留存为流水线产物，可直接下载
    paths:
      - target/*.jar

这套方案下本地开发和流水线构建共用同一套依赖规则，不会出现“本地能跑、流水线报错”的环境差异问题，后续新增、升级依赖只需要改构建配置即可，维护成本极低。

方案2：手动维护依赖类路径（适合临时极简场景） #

如果暂时不想引入构建工具、改动现有项目结构，可以手动管理依赖包：

• 先把Eclipse中项目引用的所有第三方jar包全部导出，在项目根目录新建lib文件夹存放这些jar，将整个lib目录提交到Git仓库
• 调整javac编译命令，通过-cp参数指定依赖搜索路径，编译完成后再执行打包逻辑，参考脚本如下：

build:
  stage: build
  only:
    - myBranch
  tags:
    - MyBuilder
  image: openjdk:8-jdk
  script:
    # 编译时指定lib目录下所有jar为依赖源，编译生成的class文件输出到target目录
    - javac -cp "lib/*" -d target MyPath/MyJava.java
    # 打包生成可执行jar，指定主类入口
    - jar cfe target/your-target.jar myfolder.generator.MyJava -C target .

注意这个方案需要手动维护所有依赖的版本，新增、升级依赖都要手动替换lib目录下的文件，长期维护成本很高，只适合临时测试、极小体量的项目使用。

• 你的MyJava.java声明的包名为myfolder.generator，需要确认文件在仓库中的实际存储路径和包名规则匹配，否则编译时会报类路径匹配错误
• 如果需要最终生成的jar可以独立运行，要么将所有依赖打包进同一个fat jar，要么运行时仍然通过-cp指定依赖路径，否则执行jar阶段同样会抛出类不存在的错误。

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