GitHub Actions工作流如何感知单元测试失败？

首先看测试失败的输出：

Finished in 0.0137 seconds (files took 0.0769 seconds to load)
5 examples, 1 failure

Failed examples:

rspec ./spec/basic_math_spec.rb:10 # Basic-Math Subtract numbers

Error: Process completed with exit code 1.

问题 #

• GitHub Actions会正确将测试步骤标记为错误状态。
• 但GitHub Actions是如何知晓测试已失败的呢？
• RSpec只是一款被执行的命令行软件，它是如何向上反馈异常情况，进而被识别为不符合预期的呢？

解答 #

核心是**命令行程序的退出码（Exit Code）**机制：

1. RSpec的反馈方式
   当RSpec跑完测试后，会根据结果返回对应的退出码：

• 所有测试通过时，返回退出码0；
• 存在测试失败时，返回非0的退出码（通常是1）。
  这是类Unix系统（包括GitHub Actions运行的环境）的通用约定：退出码0代表程序执行成功，非0则代表执行出现错误或不符合预期的结果。

2. GitHub Actions的判断逻辑
   GitHub Actions在执行每个步骤的命令时，会自动捕获该命令的退出码。如果检测到退出码不是0，就会判定这个步骤执行失败，将步骤标记为错误状态，同时默认终止后续的工作流步骤（除非你在步骤配置里加了continue-on-error: true）。

说白了就是：RSpec用非0退出码告诉系统“我没跑成功”，GitHub Actions盯着这个退出码，一看到非0就知道测试步骤出问题了。

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