MySQL的二进制日志（Binary Log）记录数据变更，用于主从复制和恢复，通过mysqlbinlog工具解析；其日志由事件组成，包含FORMAT_DESCRIPTION_EVENT、QUERY_EVENT、ROWS_EVENT等，不同binlog_format（STATEMENT/ROW/MIXED）影响日志内容结构，结合--start-datetime、--stop-position等参数可精准定位操作，解析输出包含位置、时间、实例ID、SQL语句或行变更详情，助力数据审计与故障排查。
MySQL 的二进制日志（Binary Log）是记录数据库所有更改数据的 SQL 语句或行数据变更的日志文件，主要用于主从复制和数据恢复。mysqlbinlog 是 MySQL 提供的一个命令行工具，用于解析和查看这些二进制日志内容。
mysqlbinlog 基本用法
mysqlbinlog 工具可以直接读取 .binlog 或 .00000x 格式的二进制日志文件，并将其转换为可读的 SQL 语句或事件描述。
常见命令格式：
-
mysqlbinlog mysql-bin.000001：直接输出日志内容 -
mysqlbinlog --start-datetime="2024-01-01 00:00:00" mysql-bin.000001：从指定时间开始解析 -
mysqlbinlog --stop-position=123456 mysql-bin.000001：在指定位置停止解析 -
mysqlbinlog --base64-output=DECODE-ROWS -v mysql-bin.000001：查看基于行的事件（ROW 模式）的详细 SQL
二进制日志的基本结构
每个 binlog 文件由多个事件（Event）组成，每个事件代表一个数据库操作。整个文件以特定格式组织，主要包含以下几类事件：
- FORMAT_DESCRIPTION_EVENT：出现在每个 binlog 文件开头，描述该文件的版本、格式及创建信息
- PRIOR_GTIDS_LOG_EVENT：记录上一次 GTID 执行的位置（GTID 模式下）
- QUERY_EVENT：记录基于语句的 SQL 操作，如 CREATE、INSERT、UPDATE 等（适用于 STATEMENT 模式）
- TABLE_MAP_EVENT：在 ROW 模式中，标识后续行操作所对应的表
- WRITE_ROWS_EVENT / UPDATE_ROWS_EVENT / DELETE_ROWS_EVENT：记录具体的行数据变更
- XID_EVENT：表示一个事务的结束（COMMIT）
- ROTATE_EVENT：表示当前日志文件结束，切换到下一个文件
日志格式（STATEMENT vs ROW）的影响
MySQL 支持三种 binlog_format：STATEMENT、ROW 和 MIXED，不同模式下日志内容差异显著：
-
STATEMENT 模式：记录原始 SQL 语句，如
UPDATE users SET age=25 WHERE id=1。优点是日志小，缺点是某些非确定性函数可能导致主从不一致 -
ROW 模式：不记录 SQL，而是记录每一行的实际变化。例如某行修改前后的值。更安全，适合复制，但日志体积大。需使用
-v或-vv参数查看详细内容 - MIXED 模式：MySQL 自动选择使用 STATEMENT 还是 ROW，兼顾效率与安全
如何解析并理解输出内容
运行 mysqlbinlog mysql-bin.000001 后，典型输出片段如下：
# at 199
#240401 10:00:00 server id 1 end_log_pos 299 CRC32 0x12345678 Query thread_id=5 exec_time=0 error_code=0
use `test`/*!*/;
SET TIMESTAMP=1712000000/*!*/;
INSERT INTO users(name,age) VALUES('Alice',23)
/*!*/;
关键字段说明：
- # at XXX：事件在文件中的起始位置
- server id：产生该日志的 MySQL 实例 ID
- end_log_pos：该事件结束后的位置，可用于定位下一个事件
- Query：事件类型，这里是 SQL 语句
- exec_time：语句执行耗时（秒）
- error_code：执行是否成功（0 表示无错）
对于 ROW 模式的事件，输出类似：
# at 400 #240401 10:01:00 server id 1 end_log_pos 500 CRC32 0xabcdefg Table_map: `test`.`users` mapped to number 123 # at 500 #240401 10:01:00 server id 1 end_log_pos 580 CRC32 0xbcdefgh Write_rows: table id 123 flags: STMT_END_F ### INSERT INTO `test`.`users` ### SET ### @1=4 // id ### @2='Bob' // name ### @3=26 // age
其中 @1、@2、@3 对应表字段，通过 --verbose (-v) 显示为注释形式。
基本上就这些。掌握 mysqlbinlog 解析方法和日志结构，有助于排查数据变更、恢复误删记录或分析主从延迟问题。
