Solana 项目构建问题：工具链版本不兼容

解决 Rust 版本兼容性问题 error: rustc 1.79.0-dev is not supported by the following packages:

问题背景

在开发 Solana Anchor 项目时，经常会遇到工具链版本不兼容的问题。本文档记录了一次典型的工具链重装过程，旨在帮助开发者快速解决类似的版本冲突问题。

问题现象

1. 初始编译错误

Error: Function _ZN131_$LT$solana_program_ed25519_dalek_bump..instruction..InstructionError$u20$as$u20$solana_frozen_abi..abi_example..AbiEnumVisitor$GT$13visit_for_abi17h93da246eef4af815E Stack offset of 6592 exceeded max offset of 4096 by 2496 bytes, please minimize large stack variables. Estimated function frame size: 6656 bytes. Exceeding the maximum stack offset may cause undefined behavior during execution.

2. Rust 版本兼容性错误

error: rustc 1.79.0-dev is not supported by the following packages:
  base64ct@1.7.3 requires rustc 1.81
  solana-address@1.0.0 requires rustc 1.81.0
  solana-hash@3.0.0 requires rustc 1.81.0
  solana-instruction-error@2.0.0 requires rustc 1.81.0
  solana-program@3.0.0 requires rustc 1.81.0
  solana-program-entrypoint@3.1.0 requires rustc 1.81.0
  solana-program-error@3.0.0 requires rustc 1.81.0
  solana-pubkey@3.0.0 requires rustc 1.81.0
  solana-sanitize@3.0.1 requires rustc 1.81.0

3. Cargo.lock 版本问题

error: failed to parse lock file at: /Users/tinachan/temple/anchor/Cargo.lock

Caused by:
  lock file version 4 requires `-Znext-lockfile-bump`

问题根源分析

  1. 栈内存溢出：Anchor 程序中的账户结构体过大，超过了 Solana 的 4096 字节栈限制
  2. 工具链版本过旧：当前使用的 Solana CLI (v2.1.21) 内置的 rustc 版本为 1.79.0-dev，无法满足新版本依赖的要求
  3. 依赖版本冲突：项目依赖的包需要更新的 Rust 编译器版本
  4. Cargo.lock 格式问题：使用了实验性功能生成的锁文件版本与稳定工具链不兼容

解决方案

第一阶段：修复栈内存溢出

对大型账户结构体应用 Box<Account<'info, T>> 包装：

第二阶段：清理构建缓存

cd anchor
rm -rf target
rm Cargo.lock
cargo clean

第三阶段：降级不兼容依赖

尝试降级特定包版本以匹配当前工具链：

cargo update base64ct@1.7.3 --precise 1.6.0
...

没用，好像因为某个依赖一直都没法编译成功，所以准备重装solana

第四阶段：重装 Solana 工具链

调用

sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

会报错，无法连接。。。

使用 Anza 官方的最新稳定版本：


# 安装新工具链
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

➜  anchor git:(main) ✗ solana --version                                                                           
solana-cli 2.3.10 (src:b3ae6759; feat:2142755730, client:Agave)

成功兼容所有依赖！！

参考

https://solana.stackexchange.com/questions/19629/anchor-build-error-solana-program-requires-rust-1-79-0-but-solana-tools-use-1