Canal启动失败因Metaspace不足，需在JVM参数中设置-XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m；远程连接需配置canal.ip为服务器真实IP；客户端收不到数据主因MySQL权限不足、instance配置错误或TSDB未启用；字段null多因字符集不匹配或表结构未同步。
Canal服务端启动失败：java.lang.OutOfMemoryError: Metaspace
Canal服务端（canal-server）默认用较小的JVM元空间，一加载多个表结构或开启全库订阅就崩。这不是配置错，是堆外元数据真不够。
- 进
conf/start.sh或bin/startup.bat，在JVM_OPTS里加-XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m - 别只调
-Xmx；Canal解析binlog时大量动态生成类（比如不同表对应的Entry对象），Metaspace才是瓶颈 - 若用Docker，得在
docker run命令里透传 JVM 参数，光改容器内start.sh没用
客户端连不上 canal-server：报 ConnectException: Connection refused
90% 是服务端没真正监听到指定端口，不是网络不通。Canal默认监听 127.0.0.1:11111，本机连没问题，但Java客户端跑在另一台机器上就必然失败。
- 检查
conf/canal.properties中canal.ip是否为空——留空即绑定127.0.0.1；要远程连接，必须设为服务器真实IP（如192.168.1.100） -
canal.port改了之后，客户端CanalConnector的构造参数也得同步更新，不能硬写11111 - Linux上记得关防火墙：
sudo ufw disable或放行对应端口，别只查netstat看端口开着就以为通了
Java客户端收不到binlog变更：connector.subscribe() 后一直阻塞
Canal客户端不是“注册即收”，它得先定位到一个合法的binlog位置。如果服务端没配置好MySQL账号权限、或者position已过期，subscribe() 就卡住不返回，也不会抛异常。
- MySQL账号必须有
SELECT, REPLICATION SLAVE, REPLICATION CLIENT权限，少一个都会静默失败 -
conf/example/instance.properties中的canal.instance.master.address必须写成ip:port格式（如192.168.1.200:3306），不能写localhost或域名（DNS解析失败时 Canal 不报错） - 首次启动前，建议手动执行
canal.instance.master.timestamp=0（从当前位点开始），避免因找不到历史binlog文件而停住
解析出来的 RowData 字段值全是 null 或类型错乱
Canal本身不读MySQL表结构，而是靠解析binlog里的字段序号 + 客户端本地缓存的列名映射来填充。一旦表结构变更（比如加字段）、或客户端没触发自动刷新，就会对不上。
立即学习“Java免费学习笔记（深入）”；
- 确认
canal.instance.tsdb.enable=true并配好ZooKeeper或数据库存储，否则表结构只存在内存里，重启就丢 - Java客户端收到
EntryType.ROWDATA后，别直接用column.getName()当key取值；优先用column.getIndex()对齐原始binlog顺序，再查本地schema - MySQL用了
utf8mb4但 Canal 配置里canal.instance.connectionCharset还是UTF-8（缺mb4），会导致字符串截断或乱码，看起来像null
Canal的坑不在代码怎么写，而在 MySQL 权限、网络绑定、字符集、TSDB 这四点上稍有偏差，整个链路就静默失效。调的时候别急着改客户端逻辑，先盯死这四个配置项。
