Jekyll构建报错但GitLab CI仍完成部署的原因及失败触发方案咨询

为什么错误出现但构建仍成功？ #

这是Jekyll的默认行为导致的：当单个页面（比如你的immaculate.md）存在YAML解析错误时，Jekyll只会跳过这个有问题的页面，继续完成剩余内容的构建，并且整个jekyll build命令会返回成功的退出码（0）。而GitLab CI是根据脚本的退出码来判断作业是否失败的，只要命令返回0，CI就会认为构建没问题，继续上传产物，哪怕部分页面缺失。

方案1：让构建遇到错误直接失败（推荐） #

你可以给jekyll build命令添加--strict_front_matter参数，这个参数会强制Jekyll在遇到任何前置YAML错误时，立刻终止构建并返回非0的退出码。这样GitLab CI就会把这个作业标记为失败，不会上传不完整的网站产物。

修改你的.gitlab-ci.yml配置：

build-jekyll:
  stage: build
  image: jekyll/jekyll:4.2.0
  script:
    - jekyll build --strict_front_matter -d public
  artifacts:
    paths:
      - public
  only:
    - master

方案2：仅告警但不终止构建（按需选择） #

如果你希望Jekyll继续完成构建，但要确保能及时发现错误，可以通过日志检测的方式，在CI脚本里判断是否有错误输出，再决定是否标记作业失败。不过这种方式可能存在误判风险（比如部分插件日志也可能包含"Error:"），仅作为备选：

build-jekyll:
  stage: build
  image: jekyll/jekyll:4.2.0
  script:
    # 把构建日志输出到终端同时保存到文件
    - jekyll build -d public 2>&1 | tee build.log
    # 检测日志中是否有Error:关键字，有则退出并标记失败
    - if grep -q "Error:" build.log; then echo "发现构建错误，终止作业！"; exit 1; fi
  artifacts:
    paths:
      - public
    # 可选：把构建日志作为CI报告保存，方便后续查看
    reports:
      dotenv: build.log
  only:
    - master

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