如何优化Jenkins运行的Bash脚本中重复的退出错误码1逻辑？

你脚本里反复写的if [ $? -ne 0 ]; then exit 1; fi确实太冗余了，而且容易漏写——尤其在Jenkins环境下，我们需要确保任何环节出错都能让任务以错误码1终止，这样Jenkins才能正确识别失败状态。给你两个最实用的解决方案，完全适配你的脚本：

方案一：用set -e自动实现错误退出（最简洁） #

Bash的set -e选项可以让脚本在任何命令（包括函数调用）返回非0退出码时立即终止，并且返回该错误码——刚好符合你需要的“出错就以1退出”的要求（只要你的函数失败时返回1就行）。

修改后的脚本如下：

#!/bin/bash
# 开启自动错误退出：任何命令/函数返回非0时，脚本立即终止并返回对应错误码
set -e

function getToken {
    echo "function to get token"
    # 如果需要模拟失败，只需加 return 1
}
function call_init {
    echo "Creating a config file"
}
function call_list {
    echo "calling list*"
}

# 开始执行逻辑
if [[ -z "$TOKEN" ]]; then
    TOKEN=$(getToken)
fi
echo "Creating a config file and populating it"
call_init
if [ -n "$ACTION" ]; then
    case "$ACTION" in
        'list')
            echo "Action is list"
            call_list
            ;;
        'update')
            echo "Section is update"
            ;;
        'delete')
            echo "Section is delete"
            ;;
        *)
            echo "This is a default message"
            ;;
    esac
fi

注意事项： #

• 如果某些非关键命令允许失败（比如检查某个文件是否存在），可以用command || true来忽略错误，例如：ls /tmp/non_exist_file || true
• 如果需要在退出前做清理操作（比如删除临时文件），可以结合trap使用：

  set -e
  
  # 定义退出时的清理逻辑
  cleanup() {
      echo "Cleaning up temporary files..."
      rm -rf /tmp/my_temp_dir
  }
  
  # 注册trap，脚本退出时自动执行cleanup
  trap cleanup EXIT
  

方案二：自定义错误处理函数（更灵活） #

如果你不想用set -e（比如需要自定义错误提示），可以把重复的错误检查逻辑封装成一个函数，让代码更简洁，还能添加更清晰的报错信息：

#!/bin/bash

# 自定义错误检查函数：接收退出码和错误提示，出错时打印信息并以1退出
check_error() {
    local exit_code=$1
    local error_msg=$2
    if [ $exit_code -ne 0 ]; then
        echo "Error: $error_msg" >&2  # 把错误信息输出到stderr，Jenkins会高亮显示
        exit 1
    fi
}

function getToken {
    echo "function to get token"
    # 模拟失败：return 1
}
function call_init {
    echo "Creating a config file"
}
function call_list {
    echo "calling list*"
}

# 开始执行逻辑
if [[ -z "$TOKEN" ]]; then
    TOKEN=$(getToken)
    check_error $? "Failed to retrieve authentication token"
fi
echo "Creating a config file and populating it"
call_init
check_error $? "Failed to create and populate config file"
if [ -n "$ACTION" ]; then
    case "$ACTION" in
        'list')
            echo "Action is list"
            call_list
            check_error $? "Failed to execute list action"
            ;;
        'update')
            echo "Section is update"
            ;;
        'delete')
            echo "Section is delete"
            ;;
        *)
            echo "This is a default message"
            ;;
    esac
fi

优势： #

• 减少冗余代码，让脚本更易读
• 自定义的错误提示能帮你在Jenkins日志里快速定位问题
• 可以根据需求扩展函数逻辑（比如发送告警邮件等）

总结 #

如果你的脚本没有特殊的错误处理需求，优先用set -e——它最简洁，完全能满足你让Jenkins任务在出错时以1退出的要求；如果需要更精细的控制（比如自定义报错、清理操作），就用自定义函数的方式。

内容的提问来源于stack exchange，提问作者B.T Anand