Hardhat部署HelloWorld合约报HH700未找到Artifact错误如何解决

问题现象 #

学习以太坊官方全栈HelloWorld智能合约教程时，部署环节触发如下报错：
HardhatError: HH700: Artifact for contract "HelloWorld" not found.
该报错常规诱因是合约命名不匹配，但核对后确认合约定义名称与部署脚本中调用的合约名称完全一致。执行编译命令时终端仅提示Nothing to compile，执行部署命令npx hardhat run scripts/deploy.js --network ropsten时稳定复现上述错误。

关联代码 #

HelloWorld.sol合约代码 #

pragma solidity >=0.7.3;

contract HelloWorld {
   event UpdatedMessages(string oldStr, string newStr);
   string public message;

   constructor(string memory initMessage) {
      message = initMessage;
   }

   function update(string memory newMessage) public {
      string memory oldMsg = message;
      message = newMessage;
      emit UpdatedMessages(oldMsg, newMessage);
   }
}

deploy.js部署脚本代码 #

async function main() {
  const HelloWorld = await ethers.getContractFactory("HelloWorld")

  // 发起部署，返回解析为合约对象的Promise
  const hello_world = await HelloWorld.deploy("Hello World!")
  console.log("Contract deployed to address:", hello_world.address)
}

main()
  .then(() => process.exit(0))
  .catch((error) => {
    console.error(error)
    process.exit(1)
  })

排查解决步骤 #

按优先级从高到低依次排查：

• 检查合约文件存放路径：Hardhat默认仅扫描编译项目根目录下contracts/文件夹内的.sol文件，如果把HelloWorld.sol放在了根目录、scripts目录或其他自定义位置，Hardhat编译阶段找不到源文件，就会返回Nothing to compile，自然不会生成对应合约的artifact文件，直接把合约文件移动到contracts目录下即可。
• 清理缓存强制重编译：如果路径确认无误，先执行npx hardhat clean命令清除历史编译缓存和已生成的artifacts目录，再执行npx hardhat compile手动触发编译，正常情况下会提示编译成功并生成对应合约的artifact文件，之后再执行部署命令就不会触发HH700错误。
• 核对Hardhat配置文件：打开项目根目录下的hardhat.config.js，确认没有自定义修改paths.sources配置项（即合约源文件扫描路径），如果做过自定义修改，要把HelloWorld.sol放到你配置的对应路径下；没有修改配置的话保持默认的./contracts路径即可。
• 检查合约文件后缀：确认合约文件后缀为.sol，不要存成.txt、.sol.txt这类被系统隐藏后缀的错误格式，Windows系统建议先开启文件扩展名显示后再核对。

核心判断逻辑：只要编译阶段返回Nothing to compile，就说明Hardhat根本没有扫描到有效可编译的Solidity源文件，此时不需要纠结合约命名匹配问题，优先解决编译阶段的文件扫描问题，编译成功生成artifact后，部署阶段的HH700错误会自动解决。

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