Truffle迁移智能合约误报Solidity编译器版本不匹配

问题描述 #

编译阶段抛出异常：

Source file requires different compiler version (current compiler is 0.8.10+commit.fc410830.Emscripten.clang)
报错提示两个.sol文件存在pragma solidity >=0.4.25 <0.7.0;版本声明，但对应文件中实际不存在该语句。

已确认的配置项：

• 自有业务合约均声明pragma solidity >=0.8.0 <0.9.0，适配0.8.x版本
• 执行truffle version返回结果显示当前使用solc版本为0.8.10
• 多次核查配置未发现显式的低版本声明

根因说明 #

该报错通常不是业务合约配置错误导致，核心原因是遗漏了项目中自动生成的合约、第三方依赖的版本声明，或是旧编译缓存引发的版本识别异常。

排查解决步骤 #

按以下优先级依次操作即可定位问题：

• 优先检查contracts/Migrations.sol
  Truffle旧版本脚手架初始化项目时自动生成的Migrations.sol，默认固定写有pragma solidity >=0.4.25 <0.7.0;声明，绝大多数用户改完业务合约后会遗漏这个迁移入口文件，直接将该文件的pragma声明修改为和业务合约一致的pragma solidity >=0.8.0 <0.9.0;即可解决80%的同类问题。
• 全局检索低版本pragma声明
  不要只核查自己编写的业务合约，在项目根目录全局搜索关键词>=0.4.25 <0.7.0，重点排查三类位置：
  1. contracts目录下的旧合约备份文件、未被主动引用的残留合约文件
  2. node_modules中引入的第三方合约依赖（比如低版本OpenZeppelin合约、其他工具类合约包）
  3. 软链接/复制到contracts目录下的外部合约文件
     如果是第三方依赖版本不匹配，升级对应依赖到支持0.8.x的版本即可，不需要修改node_modules内的文件。
• 清理编译缓存
  旧版本编译产生的缓存会导致pragma识别异常，在项目根目录执行以下命令清理后重新编译：

  truffle clean
  rm -rf ./build
  truffle compile
  

• 核对项目级编译器配置
  不要仅依赖truffle version的全局版本输出，打开项目根目录的truffle-config.js，确认compilers配置项明确指定了0.8.10版本，不要使用范围版本符，正确配置参考：

  module.exports = {
    // 其他配置...
    compilers: {
      solc: {
        version: "0.8.10",
        settings: {
          optimizer: {
            enabled: true,
            runs: 200
          }
        }
      }
    }
  }
  

  注意删除配置文件中冗余的多版本solc配置，避免配置覆盖。
• 排除编辑器插件干扰
  VS Code的Solidity类插件会自带独立的solc编译器，插件抛出的版本提示和Truffle本身的编译报错容易混淆，直接在终端执行truffle compile查看纯命令行下的报错信息，不要以编辑器的红线提示作为唯一判断依据。

内容的提问来源于stack exchange，提问作者Damiano Schirinzi