代理合约常见错误清单
代理合约的强大伴随着复杂性，几乎每一类错误都可能造成严重后果。本文以 代理合约常见错误 为题，梳理生产环境中最常见的几类问题，并结合 Binance 智能链上的案例，给出可落地的避坑方案。
一、存储错位：字段顺序的一字之差
升级时如果在旧字段之前插入新字段，整个存储布局会向后偏移，导致所有用户数据错乱。规避方式是：所有新增字段必须放在末尾，并通过 OpenZeppelin 的校验工具自动检测。许多 币安 链上的稳定币项目正是因为遵守这一规则，才能在多次升级后依然保持账本干净。
二、构造函数与 initializer 混用
代理场景下不能用构造函数初始化状态。常见错误是同时编写构造函数与 initializer，结果 implementation 部署后留下未受保护的初始化函数，可能被抢跑。解决办法是给 implementation 加上 _disableInitializers，并在测试中专门覆盖这一路径。在 B安 上做合约审计时，这是必查项。