Gitlab中构建失败（Build FAILED）但任务状态显示成功问题排查

我之前处理过好几个类似的GitLab CI状态异常的问题，结合你给出的配置来看，核心问题应该是容器的退出码没有正确传递给GitLab，导致它误判任务成功。咱们一步步来分析和解决：

你的现有配置 #

Dockerfile #

FROM mm_php:7.1
ADD ./docker/test/source/entrypoint.sh /work/entrypoint.sh
ADD ./docker/wait-for-it.sh /work/wait-for-it.sh
RUN chmod 755 /work/entrypoint.sh && chmod 755 /work/wait-for-it.sh
ENTRYPOINT ["/work/entrypoint.sh"]

entrypoint.sh #

#!/bin/bash -e
/work/wait-for-it.sh db:5432 -- echo "PostgreSQL started"
./vendor/bin/parallel-phpunit --pu-cmd="./vendor/bin/phpunit -c phpunit-docker.xml" tests

docker-compose.yml（片段） #

version: '2'
services:
  # 你的服务配置...

问题根源 #

GitLab CI判断任务成功的唯一标准是容器最终的退出码：退出码为0时标记为SUCCESS，非0则标记为FAILED。现在出现“测试失败但状态显示成功”的矛盾，大概率是这两个环节出了问题：

1. parallel-phpunit在测试失败时没有返回非0的退出码，导致脚本认为任务完成
2. 脚本的错误处理逻辑（比如bash -e）没有正确捕获测试命令的失败状态

解决方案 #

1. 强制传递测试命令的退出码 #

修改你的entrypoint.sh，显式捕获测试命令的退出码并作为脚本的最终退出码返回，避免任何中间环节“吃掉”错误信号：

#!/bin/bash -e
/work/wait-for-it.sh db:5432 -- echo "PostgreSQL started"

# 执行测试并保存退出码
./vendor/bin/parallel-phpunit --pu-cmd="./vendor/bin/phpunit -c phpunit-docker.xml" tests
TEST_EXIT_CODE=$?

# 打印退出码方便调试（可选）
echo "测试命令退出码: $TEST_EXIT_CODE"

# 用测试的真实退出码作为脚本的最终退出码
exit $TEST_EXIT_CODE

2. 验证parallel-phpunit的行为 #

先手动在容器内测试：单独运行测试命令后执行echo $?，查看退出码。如果测试失败时它仍然返回0，说明是这个工具本身的问题——你需要检查它的文档，确保它在测试失败时返回非0退出码，或者更换为更可靠的并行测试工具。

3. 加固wait-for-it.sh的错误处理 #

有些版本的wait-for-it.sh在连接数据库失败时可能返回0，导致脚本继续执行测试（此时测试必然失败，但GitLab可能还是拿不到错误码）。可以给它加上强制退出逻辑：

/work/wait-for-it.sh db:5432 -- echo "PostgreSQL started" || exit 1

4. 检查GitLab CI的容器调用逻辑 #

如果你的.gitlab-ci.yml里用了docker-compose up，要确保它正确捕获容器的退出码。比如：

test_job:
  script:
    - docker-compose up --build --abort-on-container-exit
    # 或者手动捕获退出码
    - docker-compose run your-test-service
    - TEST_EXIT_CODE=$?
    - docker-compose down
    - exit $TEST_EXIT_CODE

--abort-on-container-exit参数会让docker-compose up在第一个失败的容器停止时就退出，并返回该容器的退出码。

调试技巧 #

在entrypoint.sh开头加上set -x，开启调试模式，这样GitLab CI日志会打印每个执行的命令和对应的退出码，方便你定位到底是哪一步出了问题：

#!/bin/bash -e
set -x # 开启调试日志

/work/wait-for-it.sh db:5432 -- echo "PostgreSQL started"
echo "wait-for-it 退出码: $?"

./vendor/bin/parallel-phpunit --pu-cmd="./vendor/bin/phpunit -c phpunit-docker.xml" tests
echo "parallel-phpunit 退出码: $?"

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