如何在SQL出现错误时让GitLab CI流水线任务自动判定失败

核心原因 #

GitLab CI 任务的成功/失败判定默认依赖脚本执行的退出状态码，只有命令返回非0值时才会标记任务失败。你场景中触发的ORA错误是Oracle SQL层面的报错，你当前使用的Oracle SQL客户端（sqlplus/sqlcl）默认不会将SQL错误转换为脚本的非0退出码，因此即使控制台打印了报错信息，shell脚本最终退出码仍为0，CI就会判定任务成功。

解决方案 #

1. 增加SQL错误退出配置 #

在SQL脚本开头添加Oracle客户端的错误控制参数，指定SQL执行出错、操作系统出错时，立刻终止执行并返回非0退出码。
修改后的toto.sql：

-- 开启错误自动退出，返回对应错误码
WHENEVER SQLERROR EXIT SQL.SQLCODE;
WHENEVER OSERROR EXIT FAILURE;

select 1 from idontexist -- 触发错误的SQL语句

2. 修正SQL调用脚本 #

你当前的toto.sh仅写了@toto.sql无法直接执行，需要补充Oracle客户端调用逻辑，示例如下（替换为你实际的数据库连接信息即可）：
修改后的toto.sh：

#!/bin/bash
# 格式：sqlcl -s 用户名/密码@//数据库地址:端口/服务名 @SQL脚本路径
# 如果使用sqlplus，将sqlcl替换为sqlplus即可
sqlcl -s db_user/db_pass@//192.168.1.100:1521/orcl @toto.sql

3. 强化CI脚本的错误捕获能力 #

在CI的script开头添加set -euo pipefail，让shell遇到任何错误、未定义变量、管道子命令错误时都直接终止并返回非0退出码，避免漏判错误。
修改后的gitlab-ci.yaml片段：

script:
    - |
      set -euo pipefail
      chmod +x ./toto.sh
      ./toto.sh

修改完成后重新执行流水线，SQL报错时客户端会返回非0退出码，GitLab CI会自动标记任务失败。

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