Jenkins 安全执行 SQL 的关键是环境隔离、连接安全、错误处理与生产防护:需显式指定连接参数、用 MYSQL_PWD 避免密码泄露、加 --force 与 --verbose、禁用 source、按环境分发脚本、执行前校验文件及编码。

直接执行 SQL 脚本本身不难,难的是让 Jenkins 在不同环境(dev/test/prod)安全、可追溯、可回滚地执行变更 —— 大多数失败不是因为 mysql 命令写错,而是权限、连接上下文、事务控制或脚本顺序没对齐。
用 mysql 命令行工具执行单个 SQL 文件最简方式
这是最基础的落地方案,适用于开发/测试环境快速验证。关键不是“能不能跑”,而是“跑的时候有没有漏掉连接参数或错误处理”:
-
mysql默认不启用--force,遇到语法错误或主键冲突会中断并退出,导致后续语句不执行 —— 建议加--force让它继续,但必须配合日志检查 - 连接必须显式指定
-h、-P、-u、-p,不能依赖~/.my.cnf(Jenkins agent 用户家目录通常为空或不可控) - 密码不能明文写在命令里(如
-p123456),会被进程列表泄露;应改用MYSQL_PWD环境变量或配置文件 +--defaults-extra-file - 示例(Pipeline 中):
sh 'MYSQL_PWD=$DB_PASSWORD mysql -h $DB_HOST -P $DB_PORT -u $DB_USER $DB_NAME
为什么 source 在 Jenkins Pipeline 里基本不能用
source 是 MySQL 客户端的内部命令,只能在交互式 mysql shell 里生效;而 Jenkins 执行的是非交互式 shell,mysql -e "source xxx.sql" 会直接报错 ERROR 1064 (42000) —— 因为 source 不是 SQL 语句,是客户端指令。
- 正确替代:用输入重定向
或管道|,例如mysql ... - 如果脚本里含多个
USE db_name或跨库操作,确保script.sql本身已显式指定库名,或在命令中传入目标库(mysql ... target_db ) - 注意:SQL 文件末尾不能有 EOF 标记或 BOM 头,否则
mysql解析失败静默退出
生产环境必须加的三道防线
上线数据库变更不是“执行完就完事”,核心是留痕、可控、可逆:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 加
--verbose --show-warnings参数,把每条语句执行结果和 warning 都打到构建日志里,方便事后审计 - 所有 DDL 变更前,用
mysqldump --no-data备份表结构;DML 变更前,用mysqldump --where="1=0"快速生成空数据快照(仅结构) - 拒绝直接执行
DROP TABLE或ALTER TABLE ... DROP COLUMN类高危语句 —— 应该走迁移工具(如 Flyway/Liquibase)或人工审批门禁(Jenkins Input Step)
用 Pipeline 实现按环境分发 SQL 脚本的典型结构
不要把所有 SQL 堆在一个文件里然后靠注释区分环境。Jenkins 的 environment 块 + when 条件 + 文件路径变量才是可持续做法:
- SQL 脚本按环境组织:
sql/dev/001_add_col.sql、sql/prod/001_add_col.sql(内容可能不同) - Pipeline 中通过
params.ENVIRONMENT或env.BRANCH_NAME判断当前上下文,动态拼出路径:sh "mysql ... - 强烈建议在执行前加校验步骤:
sh 'if [ ! -f sql/${ENVIRONMENT}/${SCRIPT_NAME} ]; then echo "Missing SQL: sql/${ENVIRONMENT}/${SCRIPT_NAME}"; exit 1; fi'
真正容易被忽略的点是:SQL 脚本的字符编码(必须 UTF8MB4)、行结束符(Linux 换行 \n,不是 Windows 的 \r\n)、以及是否包含 SET NAMES 或时区设置 —— 这些不会报错,但可能导致数据乱码或时间字段写错。每次提交 SQL 到 Git 前,用 file -i script.sql 和 dos2unix 过一遍。










