MySQL binlog结合CDC工具实现数据变更捕获是实时数据同步场景的常用方案，但配置过程中很容易踩中各类隐藏问题，影响同步链路的稳定性。
常见配置坑点及解决方案
1. binlog基础参数配置不当
binlog的核心参数设置错误是最基础也最容易忽略的问题，常见问题包括binlog格式设置错误、binlog过期时间过短。
首先binlog_format必须设置为ROW模式，STATEMENT和MIXED模式会导致CDC工具无法准确解析行级变更内容，出现数据不一致。其次expire_logs_days不要设置过短，否则CDC任务重启时需要的binlog已经被自动清理，就会触发数据丢失问题。
正确的MySQL配置文件（my.cnf）参数示例如下：
[mysqld] # 开启binlog log_bin=mysql-bin # 设置binlog格式为ROW binlog_format=ROW # 设置binlog行镜像为全量，避免CDC解析时缺失字段 binlog_row_image=FULL # binlog保留7天，根据业务需求调整 expire_logs_days=7 # 开启GTID模式，方便CDC断点续传 gtid_mode=ON enforce_gtid_consistency=ON
2. MySQL用户权限配置不全
CDC工具连接MySQL使用的账号如果权限不足，会导致无法读取binlog或者无法获取表结构信息，常见问题是没有分配REPLICATION相关权限和表级SELECT权限。
需要给CDC使用的账号分配以下权限：
- REPLICATION SLAVE：允许读取binlog内容
- REPLICATION CLIENT：允许查看binlog状态和位置
- 待同步库的SELECT权限：用于获取表结构信息，解析字段类型
- 如果是整库同步，可分配全局SELECT权限
权限配置SQL示例如下：
-- 创建CDC专用用户 CREATE USER 'cdc_user'@'%' IDENTIFIED BY 'cdc_password'; -- 分配权限 GRANT REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'cdc_user'@'%'; GRANT SELECT ON your_database.* TO 'cdc_user'@'%'; -- 刷新权限 FLUSH PRIVILEGES;
3. CDC工具参数与binlog不匹配
不同CDC工具对binlog的解析要求不同，参数配置不匹配会导致任务报错或者数据遗漏。以Debezium为例，常见问题是未开启GTID模式时，start_position配置错误，或者表白名单配置遗漏。
Debezium连接MySQL的核心配置示例如下：
{
"name": "mysql-cdc-connector",
"config": {
"connector.class": "io.debezium.connector.mysql.MySqlConnector",
"database.hostname": "127.0.0.1",
"database.port": "3306",
"database.user": "cdc_user",
"database.password": "cdc_password",
"database.server.id": "184054",
"database.server.name": "mysql-cdc",
"database.include.list": "your_database",
"table.include.list": "your_database.your_table",
"database.history.kafka.bootstrap.servers": "127.0.0.1:9092",
"database.history.kafka.topic": "schema-changes.mysql",
"include.schema.changes": "true"
}
}
如果MySQL开启了GTID模式，CDC工具需要配置对应的GTID消费参数，避免重启后重复消费或者漏消费。如果未开启GTID，需要正确配置binlog的初始文件名和位置，不要随意填写默认值。
4. 大事务和binlog单文件大小配置冲突
如果业务中存在大批量数据更新、删除的大事务，同时binlog单文件大小设置过小，会导致单个事务的binlog跨多个文件，CDC工具解析时可能出现事务不完整的问题。
建议将max_binlog_size设置为512M或者1G，避免小文件导致的事务拆分问题。同时如果CDC工具支持大事务配置，需要开启大事务缓存，避免内存溢出。
对应的MySQL配置调整如下：
[mysqld] # 设置binlog单文件大小为1G max_binlog_size=1073741824
5. 字符集和时区配置不一致
MySQL服务端字符集、时区与CDC工具配置的字符集、时区不一致，会导致解析出来的中文乱码、时间字段偏移的问题。
需要保证CDC工具配置的字符集和MySQL的character_set_server一致，时区配置和MySQL的time_zone一致。例如MySQL设置为UTF8MB4，时区为Asia/Shanghai，CDC工具也需要对应配置相同的参数。
配置验证方法
完成配置后可以通过以下方式验证是否生效：
- 查看MySQL的binlog状态，确认格式、GTID等参数正确：
SHOW VARIABLES LIKE 'binlog%'; - 查看CDC任务日志，确认没有权限报错、binlog读取报错
- 在MySQL中执行测试插入、更新、删除操作，确认CDC工具能正常捕获并输出变更数据
按照以上要点排查配置，基本可以解决大部分MySQL binlog+CDC工具变更捕获的配置类问题，保障同步链路的稳定运行。