如何配置GitHub Action在R抛出错误时失败并终止部署流程

GitHub Actions判定步骤/任务是否失败的核心依据是命令的退出码：只要执行的命令返回0状态，就会判定为执行成功，继续运行后续流程；只有命令返回非0状态时，才会立刻终止当前任务，标记整个工作流运行失败。
你遇到的R抛出构建错误但工作流仍继续执行部署的问题，本质是R运行时的错误没有被透传为非0退出码，被执行层吞掉了，导致GitHub Actions误判构建步骤成功，才会继续触发后续部署逻辑。

1. 给R执行命令加强制错误透传参数 #

这是最快速生效的方案，不管你是用Rscript跑自定义构建脚本，还是直接调用blogdown、rmarkdown、quarto的站点构建命令，都提前配置全局错误选项，让R遇到任何错误时立刻返回非0退出码，不要静默继续执行。
不要直接用默认的执行命令：

Rscript build.R
# 或者
Rscript -e "blogdown::build_site()"

替换为带错误处理的写法：

Rscript -e "options(error = function() { quit(status = 1) }); source('build.R')"
# 构建站点就用对应命令
Rscript -e "options(error = function() { quit(status = 1) }); blogdown::build_site()"

注意检查你的执行命令末尾，有没有|| true、|| echo "xxx"这类会强制覆盖退出码为0的写法，有的话直接删掉，这类写法是吞掉错误的常见原因。

2. 修正工作流的任务依赖与错误配置 #

检查你的workflow配置文件，修正两个容易踩的配置问题：

• 删掉所有R构建步骤里的continue-on-error: true配置，这个参数会强制让步骤无论出什么错都被判定为成功
• 如果构建和部署拆成了两个独立job，必须给部署job加needs: 构建任务的job_id配置，GitHub Actions默认如果前置依赖的任务失败，后续任务会直接跳过不会执行。

参考正确的工作流片段配置：

jobs:
  build-web:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: r-lib/actions/setup-r@v2
        with:
          r-version: 'release'
      # 安装依赖步骤省略
      - name: 构建R站点
        run: |
          options(error = function() { quit(status = 1) })
          blogdown::build_site()
        shell: Rscript {0}
      # 构建产物上传步骤省略
  deploy-web:
    runs-on: ubuntu-latest
    needs: build-web # 强制依赖构建任务，构建失败则本任务直接跳过
    steps:
      # 部署步骤省略

3. 修正R脚本内部的异常捕获逻辑 #

如果你自己写的构建脚本里用了try()、tryCatch()做异常处理，注意不要把致命构建错误完全兜住不往外抛。遇到会导致站点构建失效的错误时，要主动调用quit(status = 1)返回非0状态。
错误写法（会吞掉错误）：

try(rmarkdown::render("index.Rmd"))

正确写法（捕获到错误后返回失败状态）：

render_res <- try(rmarkdown::render("index.Rmd"))
if (inherits(render_res, "try-error")) {
  quit(status = 1)
}

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