GitLab CI执行Docker Compose Exec调用PHP命令后无报错却失败

我的GitLab CI脚本执行后没有任何错误信息，但Job却失败了。我尝试了多种命令写法，结果均一致：

docker compose exec -T my-app-name bash -c 'php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json > composer-require-check-report.json'

# 我还尝试了多种变体，结果相同。

docker compose exec -T my-app-name php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json > composer-require-check-report.json

docker compose exec -T my-app-name XDEBUG_MODE=off php ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json > composer-require-check-report.json

docker compose exec -T my-app-name bash -c 'php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json' > composer-require-check-report.json

docker compose exec -T my-app-name bash -c 'XDEBUG_MODE=off php ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json > composer-require-check-report.json'

如上所述，命令已正确执行且最终生成了目标文件。该命令在本地运行正常（在Runner中似乎也正常执行），但Job就是失败，求排查思路。

排查方向： #

• 检查命令退出码：GitLab CI完全依赖命令的退出码判断成败，哪怕输出正常，只要退出码非0就会标记失败。可以在命令后追加echo $?输出退出码，或者在CI脚本中捕获：

  docker compose exec -T my-app-name bash -c 'php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json > composer-require-check-report.json'
  echo "命令退出码: $?"
  

• 排查docker compose exec的执行状态：docker compose exec会返回容器内命令的退出码，但如果容器未运行、不存在，或者exec过程中出现权限/环境问题，也会返回非0码。可以先测试基础命令验证容器连通性：

  docker compose exec -T my-app-name echo "容器连通测试"
  echo "exec命令退出码: $?"
  

  也可以开启调试模式追踪执行过程：

  set -x
  docker compose exec -T my-app-name bash -c 'php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json > composer-require-check-report.json'
  set +x
  

• 捕获完整错误输出：当前的重定向只捕获了stdout，stderr的错误信息可能被掩盖。可以将stderr也重定向到文件，或者直接输出到CI日志：

  # 捕获所有输出到同一个文件
  docker compose exec -T my-app-name bash -c 'php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json' > composer-require-check-report.json 2>&1
  # 或者不重定向，直接查看CI日志中的完整输出
  docker compose exec -T my-app-name php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json
  

• 验证容器内命令的真实状态：虽然生成了JSON文件，但composer-require-checker本身可能因为检测到依赖问题返回非0退出码（比如存在未声明的依赖）。可以直接在容器内执行命令并查看退出码：

  docker compose exec -T my-app-name bash -c 'php -d xdebug.mode=off ./vendor/maglnet/composer-require-checker/bin/composer-require-checker check --output=json; echo "内部命令退出码: $?"'
  

• 排查Runner环境差异：本地与Runner的环境可能存在差异，比如docker compose版本、用户权限、容器网络状态。可以在CI脚本中打印环境信息对比：

  docker compose --version
  whoami
  docker ps
  

• 查看GitLab CI完整日志：部分错误信息可能被截断或隐藏在日志的其他阶段（比如初始化、清理环节），仔细查看Job的完整输出日志。

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