7-Zip 测试压缩包时怎么用退出码让 CI 判断失败

自动归档后，不能只看 7-Zip 的日志里有没有红字。让 CI 正确失败的关键是执行 7z t archive.7z，并保留它的退出码：返回 0 表示没有错误，返回非零值时让当前步骤退出。7-Zip 官方地址：https://7-zip.org/7z.html。

本文只处理归档完整性测试、Shell 判断和 CI 结果核对，不涉及损坏分卷修复或密码恢复。下面的界面图都是原创说明图，不是实际软件截图。

第 1 步：先分清 t 命令和退出码

7-Zip 的 t 命令用于测试归档。它不会把文件解压到工作目录，而是读取归档并检查数据。最小命令如下：

# 测试归档完整性；命令结束后的退出码交给 CI 判断
7z t "artifacts/app.7z"

# Bash 中立即保存 7z t 的返回值，避免后面的 echo 覆盖它
status=$?
echo "7-Zip exit code: $status"
exit "$status"

常见返回值可以按下面的方式处理：

第 2 步：在 CI 命令步骤中执行 7z t

打开 CI 工作流编辑器，进入“归档检查”任务，选择“新增命令步骤”。命令字段填写 7z t artifacts/app.7z，工作目录要指向构建产物所在目录；如果界面提供“非零退出码即失败”开关，将它打开并保存。

如果 CI 没有这个开关，就把判断写进脚本。PowerShell 版本要在调用后立刻读取 $LASTEXITCODE：

# 执行归档测试，并立即保存 7-Zip 的进程退出码
& 7z.exe t "artifacts\app.7z"
$code = $LASTEXITCODE

# 非零值表示检查没有通过，把它传回 CI
if ($code -ne 0) {
    Write-Error "7-Zip archive test failed with exit code $code"
    exit $code
}
exit 0

第 3 步：避免 Shell 把失败结果吞掉

最常见的错误是把 7-Zip 放进管道后没有检查管道状态，或者在它后面执行了一个成功的命令，导致脚本最后返回 0。Linux CI 可以使用明确的状态判断：

# 不让管道或后续命令替换 7z t 的结果
set -o pipefail
7z t "artifacts/app.7z" | tee 7z-test.log
code=${PIPESTATUS[0]}

# 记录日志后仍返回 7z t 的真实状态
if [ "$code" -ne 0 ]; then
  echo "archive test failed: exit $code"
  exit "$code"
fi
echo "archive test passed"
exit 0

如果只是单条命令，CI 的 shell 步骤直接写 7z t artifacts/app.7z 通常就够了；只有需要保存日志、拼接多条命令时，才需要显式保存状态。

第 4 步：核对 CI 的退出码和日志

打开最近一次运行详情，先看步骤状态，再看日志中的归档名称和退出码。成功时应看到步骤为通过、退出码为 0；失败时要保留 7-Zip 的错误文本和非零退出码，而不是把它改写成“脚本执行完成”。

排查顺序建议固定为：先确认归档路径是否相对于当前工作目录，再确认 CI 运行账号能读取文件，最后根据 7z t 的输出判断归档本身是否有数据错误。不要只依据日志关键词，因为最终是否失败由进程退出码决定。

常见问题

退出码 1 要不要让 CI 失败？

它表示警告而不是致命错误。若归档完整性是发布前置条件，可以统一把所有非零值视为失败；若团队允许非致命警告，则只对 2、7、8、255 等值失败，并把 1 写入构建摘要。

为什么日志显示失败但 CI 仍然成功？

通常是后续命令覆盖了返回值，或管道没有启用失败传播。让脚本在调用 7-Zip 后立即保存状态，并在最后显式 exit 该状态即可。

总结

7-Zip 检查归档时使用 t 命令，CI 判断时使用进程退出码。配置命令、保存原始状态、核对日志和退出码这四步连起来，压缩包测试失败就能真正阻断流水线。