GitHub Action执行package-lock.json校验脚本报退出码1,本地运行正常
GitHub Action脚本执行失败问题排查与修复
核心问题根源
你遇到的步骤持续失败,并非pipefail配置逻辑导致,本质是脚本本身的退出码判断逻辑完全不符合预期,具体拆解为两点:
- 命令触发逻辑与校验目标反向
按照bash的&&执行规则,你当前的命令grep resolved package-lock.json | grep -q example.com && echo "xxx" && exit 1执行时:- 当
grep -q example.com找到匹配内容(即确实存在example.com的无效条目,属于应拦截的异常场景):会触发后续的提示和exit 1,让步骤失败,这部分逻辑符合预期 - 当
grep -q example.com找不到匹配内容(即没有无效条目,属于校验应通过的正常场景):grep找不到匹配时会返回退出码1,&&链路直接中断,此时整个脚本的最终退出码就是1。而GitHub Action会将所有非0退出码判定为步骤执行失败,这就导致无论是否存在无效条目,步骤都会被判定失败
- 当
- 冗余多管道写法放大了退出码误差
你将校验拆成两段grep,先搜包含resolved的行、再从结果中筛选example.com的内容,这种写法本身需要额外处理管道每一环的退出码,加上没有兜底的退出码判断,很容易出现非预期的执行结果。
补充:你在本地验证时觉得脚本运行正常,大概率是本地仓库的package-lock.json刚好存在example.com的匹配条目,触发了预期的拦截逻辑;但GitHub Action拉取的远端代码仓库的package-lock.json不存在这类条目,就会直接卡在无匹配时的非0退出码上,和本地运行场景不一致。
修复方案
将脚本逻辑调整为明确区分两种场景的退出码,无需自定义shell模板即可正常运行,调整后的完整步骤配置:
steps: - uses: actions/checkout@v2 - name: Validate package-lock.json file run: | # 单条正则同时匹配包含resolved字段、example.com地址的无效行 if grep -q '"resolved".*example\.com' package-lock.json; then echo "package-lock.json contains invalid entries" exit 1 fi # 校验通过时主动返回0退出码,避免grep无匹配导致的非0结果 exit 0
如果偏好单行写法,可以调整为:grep -q '"resolved".*example\.com' package-lock.json && { echo "package-lock.json contains invalid entries"; exit 1; } || exit 0
优化说明
- 原配置中
bash --noprofile --norc {0}的自定义shell模板不需要特意保留,GitHub Action在Ubuntu运行环境下的默认bash执行已经覆盖这类场景 - 搜索正则中将
.com转义为\.com,避免把任意通配符的匹配结果误判为无效条目
内容的提问来源于stack exchange,提问作者Krzysztof Krasoń
相关产品推荐
相关产品推荐

