如何让GitLab CI/CD流水线在Doxygen执行失败时终止运行

我来帮你搞定这个问题！核心问题出在Doxygen没有返回错误退出码，或者CI脚本没正确捕获这个错误码，导致流水线误以为任务成功。下面是分步解决方法：

1. 修正Doxygen配置的WARN_AS_ERROR选项 #

你当前配置里的WARN_AS_ERROR = FAIL_ON_WARNINGS可能存在兼容性问题——Doxygen的WARN_AS_ERROR标准取值是YES（从1.8.16版本开始也支持FAIL_ON_WARNINGS作为等效值，但YES适配更多版本）。修改你的Doxyfile：

WARN_AS_ERROR = YES

这样Doxygen检测到未文档内容、参数缺失文档等警告时，会直接返回非零退出码，明确告诉CI任务这是失败状态。

2. 确保GitLab CI脚本捕获Doxygen的退出码 #

即使Doxygen返回了错误码，如果CI脚本没正确处理，流水线还是会标记成功。在你的.gitlab-ci.yml中，执行Doxygen的步骤要让脚本随Doxygen的退出码终止：

doxygen-docs:
  image: doxygen/doxygen:latest
  script:
    - doxygen Doxyfile || exit 1

或者更明确地捕获退出码：

doxygen-docs:
  image: doxygen/doxygen:latest
  script:
    - doxygen Doxyfile
    - exit $?

这样只要Doxygen运行触发警告（返回错误码），整个CI任务就会直接失败。

3. 验证Docker镜像的Doxygen版本 #

如果用的是较旧的Doxygen镜像，可能不支持WARN_AS_ERROR选项。建议使用官方最新镜像（doxygen/doxygen:latest），或者指定一个已知支持该选项的稳定版本（比如doxygen/doxygen:1.9.8），避免版本兼容坑。

4. 手动确认Doxygen确实能检测到警告 #

可以先在本地Docker容器中运行Doxygen，验证是否输出了预期的警告：

docker run --rm -v $(pwd):/workdir doxygen/doxygen:latest doxygen Doxyfile

如果没看到警告输出，可能是代码中没有未文档的内容，或者其他配置（比如EXTRACT_PRIVATE）影响了检测范围，需要核对Doxygen的输出日志进一步排查。

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