GitLab CI任务失败时输出截断，如何始终获取完整输出？

我来帮你搞定这个GitLab CI日志截断的麻烦！你遇到的情况是before_script里的命令失败后，第一次只显示退出码，重试才出完整错误，主要是因为默认日志输出策略和环境不匹配导致的，下面给你几个可行的解决办法：

1. 开启CI调试追踪，强制输出完整日志 #

GitLab CI有个内置变量CI_DEBUG_TRACE，开启后会输出所有执行步骤的详细日志，包括命令的标准输出和错误输出，哪怕是before_script阶段失败也不会截断。

你只需要在.gitlab-ci.yml里添加这个变量：

variables:
  CI_DEBUG_TRACE: "true"

开启后，任务执行时会打印每一条执行的命令和对应的输出，再也不会出现错误信息被吞掉的情况。

2. 显式指定匹配的Docker镜像（推荐方案） #

你没指定Docker镜像的话，GitLab Runner会使用默认的执行环境（通常是Debian/Ubuntu系列），这类系统本来就没有yum命令——这也是你报错的根源！

直接换成CentOS/RHEL系的镜像，比如centos:7或者rockylinux:8，既解决了yum不存在的问题，也能让环境更稳定，日志输出更完整：

# 全局指定镜像，所有job都用这个环境
image: centos:7

before_script:
  - yum install curl -y

这样不仅能避免基础命令缺失的错误，还能确保每次任务执行的环境一致，日志也不会莫名截断。

3. 修改before_script命令，确保错误输出被捕获 #

如果暂时不想换镜像，可以调整命令的输出重定向，把错误信息强制合并到标准输出里，让GitLab CI能捕获到完整内容：

before_script:
  # 把stderr合并到stdout，确保错误信息被记录
  - yum install curl -y 2>&1

或者开启脚本的调试模式，让每一步命令都打印出来：

before_script:
  # set -x会打印每个执行的命令，-e确保出错就退出
  - set -euxo pipefail
  - yum install curl -y

这样哪怕命令失败，你也能看到完整的错误提示。

4. 调整自托管Runner的日志级别（仅适用于自己搭建的Runner） #

如果你用的是自托管的GitLab Runner，可以修改它的配置文件config.toml，把日志级别改成debug，这样Runner会记录更详细的任务执行日志：

[[runners]]
  # 其他配置...
  log_level = "debug"

修改后重启Runner，就能在Runner的日志里看到任务执行的完整输出了。

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