GitHub Actions 检测master合并至develop冲突时避免工作流中断的方法

问题场景 #

• 要实现的功能：在 GitHub Actions 工作流里做 master 合入 develop 的前置校验，自动判断合并会不会产生代码冲突，没冲突就执行正式合并并推送代码，有冲突就终止流程并输出明确提示。
• 原来写的核心检测脚本：

git checkout develop
git merge --no-commit --no-ff master
echo '::set-output name=mergeResult::$?'
git merge --abort

• 本来的设计思路：跑一次不生成实际提交的临时合并操作探测冲突，把探测命令的返回码存成工作流输出变量mergeResult，后面的节点读取这个变量，返回0就执行正式合并推送，返回1就终止流程提示冲突。
• 实际运行的问题：只要临时合并真的触发了内容冲突，git merge --no-commit --no-ff master 就会返回非0退出码，GitHub Actions 默认碰到命令返回非0码就直接把整个工作流中断，后面的读取返回码、中止临时合并这些步骤根本无法执行，直接抛出 CONFLICT (content): Merge conflict in somefile.txt Automatic merge failed; fix conflicts and then commit the result 的报错终止流程，完全没有按照预想的分支逻辑执行。

修复方案 #

核心就是临时关闭当前检测阶段的“碰到错误就退出”拦截规则，让冲突返回的非0码能被正常捕获，保证探测、清理工作区状态、传递参数的流程完整走完，最后再根据捕获的结果决定工作流的执行方向。
修改后的核心脚本：

# 临时关闭Shell默认的遇错即退出规则，别让冲突返回的非0码直接中断流程
set +e
git checkout develop
git merge --no-commit --no-ff master
# 第一时间把临时合并命令的返回码存下来，避免被后续命令刷新覆盖
MERGE_CHECK_EXIT=$?
# 清理临时合并产生的工作区脏状态
git merge --abort
# 把存储的返回码写入GitHub Actions输出变量，供后续步骤判断使用
echo "::set-output name=mergeResult::$MERGE_CHECK_EXIT"
# 恢复默认的遇错即退出规则，避免后续正式合并、推送代码时的异常被忽略
set -e

几个容易踩的坑 #

• 一定要配置set +e：GitHub Actions 执行Shell脚本时默认开启了set -e规则，该规则下只要任意命令返回非0值，就会立刻终止整个Shell会话，这也是原脚本被中途打断的根源，不临时关闭这个规则，根本无法正常捕获非0的冲突返回值。
• 必须把返回码提前存入单独变量：Shell环境中的$?永远是紧邻的上一条执行命令的返回值，会随着新命令执行被不断刷新，如果等git merge --abort执行完再去读取$?，拿到的是中止命令的返回值，不是最开始合并探测的结果，判断逻辑就会完全失效。
• 探测完成后一定要重新开启set -e：等冲突检测完成、工作区清理干净、输出变量传递结束，再把默认的错误拦截规则恢复，不然后续正式合并、推送代码时哪怕出现异常，也会因为错误被忽略直接推上去，引发不可控的代码变更问题。

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