canal启动失败主因是版本混淆与配置错误：需分别下载canal.deployer和canal-admin包；mysql须配row格式binlog、正确授权及认证插件；instance.properties关键参数须精准设置；deployer需在canal_local.properties中配置admin地址并确保网络连通。
Canal 服务端启动失败：找不到 canal-admin 或 canal-server 启动脚本
Canal 官方已将管理端与服务端拆分为两个独立项目，canal.deployer（即传统意义上的 canal-server）不再自带 Web 管理界面。如果你下载的是最新版 canal.deployer 压缩包，里面确实没有 startup.sh 之外的 admin 相关脚本——那是另一个仓库 canal-admin 的职责。
实操建议：
- 确认下载地址：服务端用 https://www.php.cn/link/f59dbeb3532bf7cc85d40f97588c8a80 中的
canal.deployer-*.tar.gz；管理端需单独下载canal-admin-*.tar.gz -
canal.deployer解压后目录结构应含bin/startup.sh、conf/example/instance.properties，否则是下错了包 - 若误用了
canal.server（旧版单体包），它不兼容 MySQL 8.0+ 的默认认证插件，会卡在连接阶段
MySQL 授权与 binlog 配置不生效：同步始终报 Unknown system variable 'tx_isolation' 或连接拒绝
Canal 依赖 MySQL 的 row 格式 binlog 和具备 REPLICATION SLAVE 权限的专用账号。常见错误不是权限没给全，而是 MySQL 版本和配置细节不匹配。
实操建议：
- 检查 MySQL 配置文件（如
/etc/my.cnf）中是否启用：log-bin=mysql-bin、binlog-format=ROW、server-id=1（值必须唯一且非 0） - 创建 Canal 用户时，显式指定认证插件（尤其 MySQL 8.0+）：
CREATE USER 'canal'@'%' IDENTIFIED WITH mysql_native_password BY 'canal'; - 授权语句必须包含
REPLICATION SLAVE和REPLICATION CLIENT：GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'canal'@'%'; - 执行
FLUSH PRIVILEGES;后，用mysql -ucanal -pcanal -h your_mysql_ip -e "SHOW MASTER STATUS;"手动验证账号连通性
instance.properties 关键参数配错：Canal 启动后无日志输出或反复重连
Canal 实例配置集中在 conf/example/instance.properties，其中几个参数一旦写错，服务看似启动成功，实则无法拉取 binlog。最常被忽略的是 canal.instance.master.address 和 canal.instance.dbUsername 的格式。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
实操建议：
-
canal.instance.master.address必须写成host:port（如192.168.1.100:3306），不能带http://或末尾斜杠 -
canal.instance.dbUsername和canal.instance.dbPassword要与 MySQL 中创建的账号完全一致，注意大小写和特殊字符转义（密码含$时需用反斜杠$） - 若 MySQL 开启了 GTID，必须设置：
canal.instance.gtidon=true，否则 Canal 会卡在初始化位点 - 首次部署建议关闭过滤：
canal.instance.filter.regex=.*\..*（匹配所有库表），避免因正则语法错误导致实例静默失败
Canal Admin 无法注册 Deployer：页面显示 “No server available”
Canal Admin 是中心化管理平台，Deployer 需主动上报自身信息才能被识别。这个“无可用服务”提示，90% 源于 Deployer 的 canal_local.properties 配置未指向 Admin 地址，或网络不通。
实操建议：
- 在
canal.deployer/conf/canal_local.properties（若不存在则新建）中添加：canal.register.ip=your_admin_server_ip:8089（Admin 默认端口为 8089） - 确保 Admin 已启动且监听在对应 IP（检查
canal-admin/conf/application.yml中的server.address和server.port） - 在 Deployer 服务器上执行：
telnet your_admin_server_ip 8089，确认端口可达；防火墙需放行该端口 - Admin 页面刷新后仍无服务，查看 Deployer 日志：
tail -f logs/example/example.log，搜索register success或connect refused关键字
Canal 的坑多数藏在版本对齐和配置细节里，比如 MySQL 8.0 的认证插件、GTID 开关、Admin 与 Deployer 的通信协议版本——这些地方配错，日志往往不报错，只静默失败。动手前先核对 GitHub Release 页面的版本兼容说明，比反复重启有效得多。
