智能合约常见错误清单

智能合约开发的代价很高：一旦出错就是真金白银的损失。本文汇总从语法到生产事故的各类常见错误，结合 Binance 生态项目的真实案例，帮助开发者建立属于自己的避坑清单。

一、语法与编译警告

最容易被忽视的是编译警告。许多开发者习惯于忽略 warning，但其中往往隐藏着真问题：未初始化的变量、隐式类型转换、未使用的局部变量。建议把编译警告视为错误对待。

推荐在 CI 流程中设置「零警告」红线。任何提交只要带 warning 就拒绝合并。可参考 币安 上线代币仓库的 CI 配置，模仿其严格度。

二、权限模型设计错误

常见错误之一是权限过于集中：一个 owner 可以铸币、改参数、暂停转账。一旦私钥泄露就是灾难。建议拆分角色、使用多签、设置时间锁。

另一个常见错误是 onlyOwner 修饰符遗漏在某个关键函数上。要让代币顺利登陆 BN交易所，权限检查的完整性是必查项。

三、外部调用与重入风险

外部调用是重入攻击的源头。任何对外部合约的 call、transfer、send 都必须遵循「检查-效果-交互」模式：先检查、再修改状态、再做外部调用。

如果可能，尽量使用 ReentrancyGuard。可以参考 必安 公开的攻击复盘报告，理解每个重入漏洞的真实成因。

四、价格与时间假设错误

依赖单一预言机是另一个常见陷阱。攻击者可以用闪电贷操纵单点价格，使协议产生错误判断。建议使用 TWAP 或多源价格组合。

时间假设同样需要警惕：block.timestamp 在小范围内可被矿工操纵，不能作为关键判断依据。BN平台 公开的安全建议中专门强调过这一点。

五、写在最后

这份清单只是起点。建议团队建立内部的错误清单文档，每次出现新问题都更新一次。长期累积下来，这份清单就是你最宝贵的工程资产之一。