超出最大代码大小限制的智能合约如何通过Hardhat部署？

该报错的本质是EVM网络默认对单个智能合约的部署代码大小限制为24KB，编译后的合约体积超出阈值就会触发该错误

1. 开启Solidity编译优化 #

这是成本最低的优先处理方案，直接在hardhat.config.js中调整Solidity编译配置，开启优化器：

module.exports = {
  solidity: {
    version: "0.8.19", // 替换为你实际使用的Solidity版本号
    settings: {
      optimizer: {
        enabled: true,
        runs: 100, // 数值越小，部署时代码压缩优化程度越高，运行时gas消耗越高，可根据业务场景调整
      },
      // Solidity 0.8.13及以上版本可加以下配置，进一步提升优化效果
      viaIR: true,
    }
  }
}

配置修改完成后，重新执行npx hardhat compile编译，再执行部署命令即可，绝大多数场景下该方案就能解决问题。

2. 拆分合约冗余逻辑 #

开启优化后如果仍然超出大小限制，需要对合约代码做拆分瘦身：

• 把通用可复用逻辑抽取为独立的Library库合约，库单独部署后供业务合约调用，代码体积不会计入业务合约的部署大小
• 功能复杂度高的合约可采用代理模式拆分，比如钻石代理（Diamond Proxy），将不同功能模块拆为独立的Facet合约单独部署，通过统一的代理入口对外提供服务，单个Facet的大小很容易控制在24KB以内
• 清理所有未使用的继承合约、函数、事件、状态变量，不要引入不必要的冗余代码，比如不要直接继承全量的OpenZeppelin合约，按需引入需要的功能模块即可

3. 适配目标链规则 #

部分侧链、Layer2网络支持调高合约代码大小上限，如果你部署的目标链不是以太坊主网，可确认对应链的代码大小限制，若上限高于你当前合约的编译后体积，无需调整代码直接部署即可。

内容的提问来源于stack exchange，提问作者Victor Art