缺的是REPLICATION CLIENT权限——Canal启动时需执行SHOW MASTER STATUS和SHOW BINLOG EVENTS获取binlog文件名与起始位置,仅REPLICATION SLAVE不够;必须同时具备SELECT(查表结构)、REPLICATION SLAVE(拉取binlog)和REPLICATION CLIENT(查主状态)三项权限。

Canal 连接 MySQL 报 Access denied,缺的到底是哪个权限?
最常见错误不是密码错,而是 REPLICATION CLIENT 权限缺失——Canal 启动时第一步就执行 SHOW MASTER STATUS 和 SHOW BINLOG EVENTS,没这个权限直接卡住,报错里常带 SUPER, REPLICATION CLIENT privilege(s)。只给 REPLICATION SLAVE 是不够的。
必须同时授予:
-
SELECT:Canal 要查information_schema获取表结构(字段类型、主键、索引),否则连表都列不出来;DataX 的 reader 插件也依赖它构建增量查询语句 -
REPLICATION SLAVE:用于建立复制连接、拉取 binlog 流 -
REPLICATION CLIENT:用于获取当前 binlog 文件名和起始 position,是初始化阶段必走的一步
三者缺一不可。用 GRANT ALL PRIVILEGES 是危险且多余的,Canal 完全不需要写权限。
CREATE USER + GRANT 顺序错了,权限可能不生效
MySQL 5.7 及更早版本中,GRANT 语句不写入 binlog,且不会自动刷新权限缓存;8.0+ 虽支持持久化,但若 log_bin=OFF 或 replicate_ignore_db=mysql,仍可能导致权限变更未同步到从库(对 Canal 自身影响不大,但运维一致性差)。
安全做法是:
- 先用
CREATE USER显式建用户,避免隐式创建带来的 host 匹配歧义 - 再用
GRANT ... ON *.* TO 'canal'@'10.20.30.40'精确指定 IP,别用'canal'@'%' - 最后必须执行
FLUSH PRIVILEGES,否则内存中权限未加载 - 验证命令:
SHOW GRANTS FOR 'canal'@'10.20.30.40',确保输出包含全部三项权限
如果 SHOW GRANTS 查不到结果,大概率是实际连接时匹配到了另一个 'canal'@'localhost' 或 'canal'@'%',用 SELECT User, Host FROM mysql.user WHERE User = 'canal' 确认真实账号列表。
binlog-format 不是 ROW,Canal 解析会丢变更
Canal 增量同步依赖 binlog 中的完整行镜像(before/after image),只有 binlog-format=ROW 才能拿到字段级变更。用 STATEMENT 只记 SQL 文本,MIXED 切换逻辑不可控,都会导致解析失败或漏数据。
检查方式:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
SHOW VARIABLES LIKE 'binlog_format';—— 结果必须是ROW -
SHOW VARIABLES LIKE 'log_bin';—— 必须为ON
改完 /etc/my.cnf 后记得重启服务:sudo systemctl restart mysql(Ubuntu/Debian)或 sudo systemctl restart mysqld(CentOS/RHEL)。配置写了但没重启,等于没配。
server_id 和 canal.instance.mysql.slaveId 冲突会导致找不到 binlog 文件
MySQL 主库用 server_id 标识自身身份,Canal 实例用 canal.instance.mysql.slaveId 模拟一个从库 ID。两者都必须是非零整数,且在整个集群中唯一。
典型错误现象是 Canal 日志报:
Could not find first log file name in binary log index file
原因往往是:
-
server_id在 my.cnf 里设成了 0,或与其他 MySQL 实例重复 -
canal.instance.mysql.slaveId配成 0,或与集群中其他 Canal 实例相同 - 主库已开启
replicate_ignore_db=mysql,导致mysql.user表变更不进 binlog,权限变更无法被 Canal 感知(虽不影响初始连接,但后续动态授权会失效)
阿里云 RDS 默认开了 binlog 且自带 REPLICATION CLIENT 和 REPLICATION SLAVE,但 SELECT 权限仍需手动加,这点容易忽略。










