如何在提交Liquibase前验证SQL前置条件？解决GO语句报错

方法1：Jenkins构建前加脚本批量检查 #

• 用Shell或PowerShell脚本遍历所有SQL文件，排查含GO的语句（忽略注释行），一旦发现就终止构建。
  Shell脚本示例（Linux/macOS环境）：

  # 遍历指定目录下的所有.sql文件
  for file in ./sql-scripts/*.sql; do
    # 排除--开头的注释行，查找不区分大小写的GO
    if grep -v "^--" "$file" | grep -i "GO" > /dev/null; then
      echo "错误：文件 $file 包含Liquibase不支持的GO语句"
      exit 1
    fi
  done
  

  PowerShell脚本示例（Windows环境）：

  Get-ChildItem -Path ./sql-scripts -Filter *.sql | ForEach-Object {
    $content = Get-Content $_.FullName | Where-Object { $_ -notmatch "^--" }
    if ($content -match "(?i)GO") {
      Write-Error "错误：文件 $($_.FullName) 包含Liquibase不支持的GO语句"
      exit 1
    }
  }
  

• 在Jenkins里把这个脚本放在Liquibase执行步骤之前，提前拦截问题脚本。

方法2：用Liquibase预校验规则拦截 #

• 自定义Liquibase的校验逻辑：写个简单的Java类实现ChangeLogValidator接口，在validate阶段扫描SQL内容，发现GO就抛出异常。
• 在Jenkins构建流程中，先执行liquibase validate命令触发校验，通过后再执行部署操作，从Liquibase层面提前排查问题。

方法3：Git提交钩子从源头管控 #

• 在Git仓库添加pre-commit钩子，开发者提交代码时自动检查SQL文件，不让带GO的脚本进入版本库。
  钩子脚本示例（放在.git/hooks/pre-commit）：

  #!/bin/sh
  # 检查所有待提交的.sql文件
  git diff --cached --name-only | grep "\.sql$" | while read file; do
    if grep -v "^--" "$file" | grep -i "GO" > /dev/null; then
      echo "错误：文件 $file 包含Liquibase不支持的GO语句，请移除后再提交"
      exit 1
    fi
  done
  exit 0
  

• 把这个钩子同步给所有团队成员，或者通过仓库模板统一管理，从提交环节就避免问题。

额外提示 #

• 脚本要排除注释里的GO，比如-- 这是包含GO的注释这类不需要处理。
• 如果原来用GO是为了分批执行SQL，直接把SQL拆成多个Liquibase变更集（changeSet）即可，Liquibase会按顺序执行，不需要用GO分隔。

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