如何处理Oracle SQLcl语法错误并返回shell错误码给Jenkins？

你遇到的拼写错误类语法问题属于SQLcl客户端层面的解析错误，不属于数据库返回的ORA-类错误，因此默认的WHENEVER SQLERROR无法捕获，按照以下方案配置即可覆盖这类场景：

核心SQL脚本配置 #

在PL/SQL脚本的最开头同时添加两类错误捕获规则：

-- 捕获数据库返回的ORA-xxx类运行错误，出错后自动回滚事务、断开数据库连接、返回非0错误码
WHENEVER SQLERROR EXIT FAILURE ROLLBACK;
-- 捕获SQLcl客户端层面的错误：语法解析错误、命令不识别、连接失败、文件读取失败等，出错后自动回滚事务、断开数据库连接、返回非0错误码
WHENEVER OSERROR EXIT FAILURE ROLLBACK;

Shell调用配置 #

调用SQLcl时建议加-S（静默模式）参数，避免多余输出干扰错误捕获，同时主动捕获返回码：

# 敏感账号信息建议通过Jenkins凭证注入环境变量传递，不要明文写在脚本中
sqlcl -S ${DB_USER}/${DB_PWD}@${DB_TNS} @your_plsql_script.sql
# 捕获执行返回码，非0直接中断流程
if [ $? -ne 0 ]; then
  echo "PL/SQL脚本执行失败"
  exit 1
fi

可选：双重校验兜底 #

如果存在特殊场景的错误无法通过返回码识别，可以对执行输出做关键词匹配兜底：

# 将执行输出写入日志文件
sqlcl -S ${DB_USER}/${DB_PWD}@${DB_TNS} @your_plsql_script.sql > sql_exec.log 2>&1
EXIT_CODE=$?
# 同时校验返回码和日志错误关键词，可根据实际报错信息调整匹配规则
if [ ${EXIT_CODE} -ne 0 ] || grep -iE "error|ora-|comando desconocido|invalid identifier" sql_exec.log; then
  echo "检测到PL/SQL执行错误，日志如下："
  cat sql_exec.log
  exit 1
fi

Jenkins Pipeline集成示例 #

pipeline {
  agent any
  stages {
    stage('部署PL/SQL脚本') {
      steps {
        // set -euo pipefail 保证任意子命令出错就中断步骤
        sh '''
          set -euo pipefail
          sqlcl -S ${DB_USER}/${DB_PWD}@${DB_TNS} @deploy_script.sql > sql_deploy.log 2>&1
        '''
      }
      post {
        failure {
          // 失败时输出SQL日志方便排查
          sh 'cat sql_deploy.log'
        }
      }
    }
  }
}

内容的提问来源于stack exchange，提问作者Salvador Arreola Rojas