abigen调用不报错需确保：ABI为标准JSON数组、补全合约地址或bin、输出路径为绝对路径且目录存在；函数/事件名首字母大写以满足Go导出规则；backend和client非nil并正确初始化。
go-ethereum 的 abigen 工具怎么调用才不报错
直接用 abigen 生成 Go 绑定代码，最常卡在 ABI JSON 格式不对、合约地址或 bin 缺失、输出路径权限不足这三处。它不校验 ABI 合法性，只做结构映射，所以输入一错，生成的代码编译就炸——比如字段名含 _ 或大小写混用，abigen 照单全收，但 Go 编译器会拒收。
- ABI JSON 必须是标准 Solidity 编译输出的
abi字段内容（数组），不是整个solc --combined-json输出；用jq '.contracts["Contract.sol:Contract"].abi'提取最稳 - 如果只要类型定义（不带部署逻辑），加
--type=MyContract和--pkg=contract，避免生成无用的DeployXXX函数 - 输出文件必须写完整路径，如
--out=./contract/contract.go；相对路径容易因工作目录不同导致写入失败，且abigen不自动建目录 - 别传
--bin或--sol除非真要部署——它们会触发额外校验，出错信息反而更模糊
ABI 中 event 和 function 名称大小写影响生成结果吗
影响，而且是硬性影响。Go 绑定代码里，event 和 function 最终变成 Go 方法或结构体字段，必须符合 Go 导出规则：首字母大写才可导出。Solidity 里写 transfer(address,uint256)，ABI 里就是小写 transfer，abigen 会生成小写开头的 transfer 方法——Go 编译直接报错 cannot export transfer。
- 解决方案只有两个：改 Solidity 源码（加
function Transfer(...)），或手动改 ABI JSON 里的name字段为大写（如"name": "Transfer"） - event 同理，
Transfer生成Transfer结构体，transfer生成transfer（不可导出，后续无法 decode） - 注意：改 ABI 后，必须同步更新合约部署时用的 bytecode，否则链上事件签名对不上
生成的 Go 代码为什么调用时 panic: invalid memory address
90% 是因为没初始化 *bind.BoundContract 所依赖的 backend，或者传了 nil 的 *ethclient.Client。生成的代码本身不包含网络逻辑，全是“胶水”，所有 RPC 调用都甩给传入的 backend，空指针一踩一个准。
- 检查
contract.NewMyContract(addr, client)的client是否非 nil，且已连上节点（client, _ := ethclient.Dial("https://...")） - 读状态（
myContract.Name(nil)）时，第一个参数是*bind.CallOpts，可传nil；但发交易（myContract.Transfer(...)）必须传&bind.TransactOpts{From: ..., Signer: ..., Nonce: ...} - 如果用
FilterXXX订阅 event，backend 必须支持SubscribeFilterLogs（Infura 不支持，得换 Alchemy 或本地节点）
想支持多个 EVM 链但 ABI 不同，能复用同一份生成代码吗
不能直接复用。ABI 是合约接口定义，和链无关；但生成代码里硬编码了合约地址（如果用了 --bin 或 --sol）、链 ID 相关的常量（比如某些 wrapper 会塞 chainID := big.NewInt(1)），还有 event topic hash 计算——虽然 hash 本身跨链一致，但 topic 过滤逻辑可能因节点实现差异失效。
立即学习“go语言免费学习笔记（深入）”；
- 安全做法：为每条链单独生成代码，用不同包名（
--pkg=contract_arb,--pkg=contract_opt） - 若 ABI 完全相同，可只生成一次，但运行时所有地址、链 ID、RPC endpoint 都得动态注入，不能写死在代码里
- 特别注意
ParseXXXLog函数——它用 ABI 中的inputs解析 log data，只要 ABI 一致就 OK；但FilterXXX内部构造的 filter query 可能被节点拒绝（如 Polygon 对 topic 数量有限制）
ABI 绑定本质是静态契约，生成那一刻就锁死了接口语义。改 ABI 就得重跑 abigen，指望一份代码通吃多链，最后 debug 花的时间远超多生成几次的成本。
