Windows 10下rdkafka-sys编译失败问题及修复方法咨询

问题详情 #

构建Rust项目时遭遇rdkafka-sys v4.8.0+2.3.0自定义构建命令执行失败，错误日志如下：

error: failed to run custom build command for `rdkafka-sys v4.8.0+2.3.0`

Caused by:
  process didn't exit successfully: `C:\zzy\work\rust\project\hyperswitch-main\target\debug\build\rdkafka-sys-5b6b43e37e2633c5\build-script-build` (exit code: 101)
  --- stdout
  Cloning librdkafka

  --- stderr
  Building and linking librdkafka statically
  Running command: "cp -a librdkafka/. C:\zzy\work\rust\project\hyperswitch-main\target\debug\build\rdkafka-sys-d0fe0d1747dfd315\out" in dir: .

  thread 'main' panicked at C:\Users\PC\.cargo\registry\src\index.crates.io-1949cf8c6b5b557f\rdkafka-sys-4.8.0+2.3.0\build.rs:38:19:
  Command failed with error: program not found
  note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

根因分析 #

rdkafka-sys的构建脚本硬编码了Unix系统的cp命令，但Windows默认没有预装该工具，导致构建过程找不到命令而崩溃。

修复方案 #

1. 安装Git for Windows并配置PATH #

• 下载安装Git for Windows，安装时选择**"Use Git and optional Unix tools from the Command Prompt"**选项，该选项会将cp等Unix工具添加到系统PATH。
• 重启命令行终端，进入项目目录重新执行cargo build。

2. 替换构建脚本中的cp命令（临时方案） #

• 定位到rdkafka-sys的build.rs文件：C:\Users\PC\.cargo\registry\src\index.crates.io-1949cf8c6b5b557f\rdkafka-sys-4.8.0+2.3.0\build.rs
• 将脚本中调用cp -a的部分替换为Windows原生的xcopy /E /I /H命令（参数说明：/E复制所有子目录，/I假设目标为目录，/H复制隐藏文件）。
• 保存文件后重新执行cargo build。

注意：此方案为临时修复，更新rdkafka-sys依赖后会失效。

3. 使用WSL2构建 #

• 在Windows 10上启用WSL2并安装任意Linux发行版（如Ubuntu）。
• 在WSL环境下克隆项目并执行cargo build，Unix工具链可正常运行，不会出现命令缺失问题。

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