--single-transaction 仍可能触发 RELOAD 权限校验,因其在事务启动失败(如被长事务阻塞、超时)或使用 --master-data=2 时自动降级为 FLUSH TABLES WITH READ LOCK,该操作强制要求全局 RELOAD 权限(ON *.*),且与 LOCK TABLES 权限独立校验,缺一不可。

mysqldump --single-transaction 为什么仍可能触发 RELOAD?
很多人误以为加了 --single-transaction 就完全绕过锁和权限依赖,但实际不是。InnoDB 表虽能靠 MVCC 做一致性快照,但 mysqldump 内部有 fallback 机制:一旦事务启动失败(比如被长事务阻塞、innodb_lock_wait_timeout 超时),它会自动降级为 FLUSH TABLES WITH READ LOCK——这一步必须有 RELOAD 权限,否则直接报错 Access denied; you need (at least one of) the RELOAD privilege(s)。
常见触发场景包括:
- 备份前已有运行超 60 秒的事务(MySQL 5.7 默认
innodb_lock_wait_timeout=50) - 系统表(如
mysql.user)被其他连接正在修改 - 使用
--master-data=2时,内部强制执行FLUSH TABLES获取 binlog 位置
LOCK TABLES 权限不是“可写”,而是“保证一致性”的关键
LOCK TABLES 权限常被误解为赋予写能力,其实它只允许用户显式加表级读锁(LOCK TABLES t1 READ),不涉及 INSERT/UPDATE/DELETE。但 mysqldump 在以下情况必须用到它:
- 混合引擎库(InnoDB + MyISAM):MyISAM 不支持事务快照,必须锁所有表
- 未指定
--single-transaction的默认行为 - 导出视图或触发器时,需锁定依赖表防止结构变更
漏掉 LOCK TABLES,即使有 RELOAD,也会报 Access denied; you need (at least one of) the LOCK TABLES privilege(s) —— 这是两个独立校验点,缺一不可。
RELOAD 必须授给 *.*,不能限定库或表
MySQL 5.7 对 RELOAD 权限的检查是全局性的:GRANT RELOAD ON app_db.* TO 'bkp'@'localhost' 看似合理,但实际无效。mysqldump 执行 FLUSH TABLES WITH READ LOCK 时,权限系统只认 ON *.* 形式。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
容易踩的坑:
- 云数据库控制台里显示授权成功,但实际未生效(阿里云 RDS 需在控制台单独开启 “RELOAD 权限开关”)
- 用户 host 不匹配:'bkp'@'localhost' 和 'bkp'@'127.0.0.1' 是两个账户,远程备份要用后者或 '%'(注意安全边界)
- 没同步给
SELECT:RELOAD 不提供读能力,GRANT SELECT ON app_db.* TO 'bkp'@'localhost'必须单独加
flush logs 失败往往暴露的是 RELOAD 权限盲区
MySQL 5.7 备份脚本里加 flush logs 是为了生成干净 binlog 起点,但它本身就需要 RELOAD。如果备份后恢复时发现 position 对不上、时间点跳变,大概率不是 mysqldump 报错,而是 flush logs 静默失败了——因为没权限,又没检查返回值。
验证方式很简单:
- 手动执行
mysql -u bkp -p -e "flush logs;",看是否报错 - Docker 环境必须进容器执行,宿主机直连通常因 bind-address 或用户 host 限制而失败
- MySQL 5.7 默认
log_error_verbosity=1,flush logs成功与否无日志,建议加&& echo "flush logs OK"辅助判断
真正麻烦的不是记不住这些权限名,而是它们只在特定 fallback 路径下才被检查——平时备份一切正常,某天凌晨一个长事务就让整个链路崩在 Access denied 上,而错误日志里根本看不出是哪个权限缺了。










