Rust Actix Web项目编译zstd-sys v2.0.9失败的解决求助

核心问题分析 #

你遇到的gcc错误“64-bit mode not compiled in”，本质是当前gcc工具链不支持64位编译，而Actix Web 4依赖的zstd-sys版本默认会尝试编译64位C扩展；Actix Web 3依赖的旧版zstd-sys对工具链要求更低，因此能编译成功。手动添加依赖无效是因为未解决工具链的根本问题，且版本匹配逻辑未理顺。

具体修复方案 #

• 检查并升级gcc工具链
  确认gcc支持64位编译：

  • 执行gcc -v查看配置，确保输出包含--enable-multilib或明确的64位支持标识
  • Windows环境：替换为MinGW-w64或MSVC工具链；Linux/macOS通过包管理器更新（如sudo apt install gcc-multilib、brew install gcc）

• 强制zstd-sys使用系统预编译库
  在Cargo.toml中添加配置，跳过源码编译，直接调用系统已安装的zstd库：

  [features]
  default = ["zstd-sys/system-zstd"]
  
  [dependencies]
  actix-web = "4.4.1"
  zstd-sys = { version = "2.0.9+zstd.1.5.5", features = ["system-zstd"] }
  

  需先安装系统级zstd开发库：Linux用sudo apt install libzstd-dev，macOS用brew install zstd，Windows下载预编译库并配置环境变量。

• 降级Rust版本适配工具链
  若无法更新gcc，可尝试将Rust降级到1.60.x（Actix Web 4最低支持版本），旧版Rust对工具链兼容性更好：
  执行rustup install 1.60.0，再用rustup default 1.60.0切换版本后重新编译。

• 核对目标架构配置
  执行rustc -vV查看host字段，确认架构与系统匹配（如32位工具链无法编译64位项目）。若不匹配，添加对应目标架构：
  例如Windows下执行rustup target add x86_64-pc-windows-gnu，编译时附加--target x86_64-pc-windows-gnu参数。

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