求助：Shell脚本无法返回正确退出码，预期1实际始终为0

可能的原因及修复方案 #

1. 脚本未以指定的bash执行 #

即使脚本开头写了#!/bin/bash，如果执行时用sh yourscript.sh调用，很多系统的sh是dash的软链接，而dash的set -e行为和bash有差异，甚至部分场景下不生效。

• 排查：在脚本开头添加echo $0，查看实际运行的Shell；直接用bash yourscript.sh执行脚本测试是否能返回非零码。

2. set -e的生效限制被触发 #

set -e有多个例外场景，命令失败也不会触发退出：

• 命令处于if/elif/while/until的条件判断中
• 命令是管道的一部分（默认仅检查管道最后一个命令的退出码）
• 命令是&&/||链式调用的一部分
• 脚本后续执行了set +e关闭了errexit选项
• 修复：
  • 若涉及管道，添加set -o pipefail（仅bash支持），让管道中任意命令失败都触发退出
  • 在关键步骤前执行set -o errexit，确认选项未被意外关闭

3. 手动判断$?时被其他命令干扰 #

如果在目标命令和$?判断之间插入了其他命令（比如echo日志），$?会被这些命令的退出码覆盖，导致判断失效。

• 错误示例：

  some_failing_command
  echo "执行了命令"
  if [ $? -ne 0 ]; then exit 1; fi
  

• 正确写法：

  # 写法1：直接在if中执行命令
  if ! some_failing_command; then
      echo "Failed"
      exit 1
  fi
  
  # 写法2：提前保存退出码
  some_failing_command
  cmd_exit=$?
  if [ $cmd_exit -ne 0 ]; then
      echo "Failed"
      exit 1
  fi
  

4. 父进程强制修改了退出码 #

如果脚本被其他进程/脚本调用，父进程可能用了set +e，或者调用时写了yourscript.sh || true这种强制返回0的逻辑，导致你看到的是父进程处理后的退出码。

• 排查：直接在终端单独执行脚本，用echo $?查看真实退出码，不要依赖父进程的日志输出。

5. Trap语句覆盖了退出码 #

如果脚本中使用了trap捕获EXIT信号，比如trap "cleanup_command" EXIT，若cleanup_command返回0，会覆盖之前的退出码。

• 修复：修改trap语句保留原退出码：

  trap "cleanup_command; exit \$?" EXIT
  

快速验证环境 #

在脚本中插入以下测试代码，直接验证基础退出逻辑：

#!/bin/bash
set -e
echo "测试退出码"
exit 1

执行bash yourscript.sh后，用echo $?查看结果。如果返回1，说明环境正常，问题出在脚本的具体业务逻辑；如果仍返回0，需检查系统全局Shell配置（比如是否有强制开启set +e的全局脚本）。

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