最可靠方式是用mysqlbinlog加--base64-output=decode-rows -v参数解析ROW格式binlog,结合binlog_format确认和位点/时间范围筛选,再人工还原###前缀的伪SQL为真实操作。

直接看 mysqlbinlog 解析出的 SQL 是最可靠的方式,但默认输出是 ROW 格式(即“改了哪些行”),不是原始 SQL。想看到 INSERT/UPDATE/DELETE 语句本身,必须配合正确参数,并确认 binlog_format 是 STATEMENT 或用 -v + --base64-output=decode-rows 强制反推。
确认 binlog_format 和日志位置
主从同步出问题时,错误日志里通常会带 end_log_pos 和文件名(如 mysql-bin.000003)。先连上主库确认当前格式和文件是否可用:
-
SHOW VARIABLES LIKE 'binlog_format';—— 如果是ROW,mysqlbinlog默认不输出 SQL,只输出行变更;如果是STATEMENT,SQL 会直接可见 -
SHOW MASTER STATUS;—— 确认当前写入的文件和位点,避免解析已 rollover 的旧文件 -
SHOW BINARY LOGS;—— 检查目标文件(如mysql-bin.000003)是否存在且未被 purge
用 mysqlbinlog 解析并还原可读 SQL
关键不是“能不能看”,而是“怎么看才不漏、不错”。mysqlbinlog 必须加特定参数才能把 ROW 格式转成类 SQL 描述:
- 基础命令:
mysqlbinlog --base64-output=decode-rows -v /path/to/mysql-bin.000003 - 按时间范围缩小范围(推荐):
mysqlbinlog --start-datetime="2026-06-09 14:00:00" --stop-datetime="2026-06-09 14:30:00" --base64-output=decode-rows -v mysql-bin.000003 - 按位点精确定位(主从报错常用):
mysqlbinlog --start-position=711518695 --stop-position=711519000 --base64-output=decode-rows -v mysql-bin.000003 - 加
--no-defaults避免读取客户端配置导致报错(如unknown variable 'default-character-set=utf8mb4')
识别真实执行的 SQL(尤其 ROW 模式下)
即使开了 -v,输出也不是标准 SQL 字符串,而是带 ### 前缀的伪代码。你需要自己拼:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
### UPDATE `db`.`table`后面的### WHERE和### SET行,对应原语句的条件和更新值 -
### INSERT INTO `db`.`table`后跟的### @1=... @2=...是字段值,顺序与表结构一致(不是与 INSERT 列表顺序) - 遇到
Can't find record in 'xxx'类错误时,重点看WHERE部分的值是否在从库已不存在——这才是主从不一致的根源 - 不要依赖
grep "DELETE"直接匹配,ROW 模式下 DELETE 只有### DELETE FROM `db`.`table`+### WHERE,没有完整语句
常见陷阱和绕过方法
很多同学卡在“明明加了 -v 却看不到 SQL”,本质是没处理好格式和权限问题:
- 文件路径写错或权限不足:确保运行
mysqlbinlog的用户有读取mysql-bin.000003的权限(常位于/var/lib/mysql/或/data/mysql/) - 忽略 GTID:如果启用了 GTID,单靠位点可能跨事务失效,优先用
--include-gtids='xxx-xxx-xxx:1-100'定位 - 字符集乱码:加
--character-sets-dir=/usr/share/mysql/charsets/(路径依实际 MySQL 安装而定) - 大文件卡住:先用
head -n 1000看前几条事件是否正常,再决定是否全量解析
真正难的不是解析命令,而是把 ### 开头的字段赋值还原成业务可理解的操作——尤其是多字段更新、JSON 字段变更、或触发器生成的隐式修改,这些在 ROW 输出里都得人工对齐表结构才能确认影响范围。










