如何正确声明Solana程序的program id解决部署ID不匹配报错

Anchor 框架的 Program ID 确定性生成规则，完全依赖部署时使用的程序密钥对：同一个密钥对无论部署多少次，生成的链上 Program ID 都是固定的。出现不匹配报错，核心原因是部署时用的密钥对，和代码里declare_id!宏声明的ID对应的密钥对不是同一个，常见触发场景是清理过target目录、手动改了代码里的ID没同步密钥、或者首次部署时没有提前绑定固定密钥。

• 第一步：获取当前部署密钥对应的真实 Program ID，在项目根目录执行命令：

  solana address -k target/deploy/<你的合约项目名>-keypair.json
  

  命令输出的字符串就是当前部署用密钥对应的真实链上ID，先复制留存。
• 第二步：同步所有位置的 Program ID 配置，三个位置必须完全一致：
  1. 打开项目根目录的Anchor.toml，找到[programs.localnet]配置段，把对应你合约名的id值替换为刚才拿到的真实ID
  2. 打开合约源码programs/<你的合约项目名>/src/lib.rs，把开头declare_id!()宏内的旧ID字符串替换为新ID
  3. 检查测试脚本、前端交互代码里硬编码的 Program ID 常量，全部同步替换
• 第三步：如果嫌手动改容易漏，直接在项目根目录执行官方提供的同步命令，会自动校验并对齐所有位置的ID配置：

  anchor keys sync
  

• 第四步：重置本地localnet状态（清除之前错误ID对应的部署残留），重新构建部署即可：

  anchor localnet
  anchor build
  anchor deploy
  

  部署完成后执行交互测试，就不会再触发ID不匹配报错。

如果需要在localnet、devnet、mainnet都使用固定不变的Program ID，避免每次重新构建部署出现ID漂移：

• 把target/deploy下对应合约的-keypair.json密钥文件备份到项目独立的keys目录（不要放在target目录下，避免清理构建缓存时被删除）
• 在Anchor.toml的[programs]配置段，给对应网络的合约配置增加密钥路径字段，示例：

  [programs.localnet]
  my_contract = { address = "你的固定Program ID", path = "keys/my_contract-keypair.json" }
  

• 注意：不要随意删除target/deploy下的合约密钥文件，一旦删除重新生成密钥，Program ID会完全变化，必须重新同步所有配置。配置固定密钥路径后，无论多少次清理构建缓存、重新部署，都会使用指定的固定密钥，Program ID永远和代码声明保持一致，不会再出现匹配错误。

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