使用cross-rs编译Rust程序时遇protoc未找到异常求助

问题背景 #

编译CnosDB（源码分支：2d870495aa65e3432755ad0bbc6a02bd957cd922）时，按以下步骤操作：

1. 构建自定义cross镜像：

docker build -t cnosdb/cross:aarch64-unknown-linux-gnu -f ./scripts/cross/aarch64-unknown-linux-gnu.dockerfile .

2. 执行交叉编译：

cross build --target aarch64-unknown-linux-gnu

编译过程中触发错误，提示prost-build找不到protoc，但镜像中已明确安装protoc（路径/usr/bin/protoc），手动设置PROTOC=/usr/bin/protoc后问题依旧。

原因分析 #

cross-rs在交叉编译时会启动隔离的容器环境，默认情况下镜像中的环境变量或可执行文件路径可能未被正确传递到编译上下文；另外prost-build的自动查找逻辑在cross的隔离环境中可能受限，导致即使设置了环境变量也无法识别。

解决方案 #

方案1：在镜像Dockerfile中配置环境变量 #

修改aarch64-unknown-linux-gnu.dockerfile，在安装protoc后添加环境变量设置：

# 假设已通过apt-get install protobuf-compiler安装了protoc
ENV PROTOC=/usr/bin/protoc

重新构建镜像，再执行编译命令。

方案2：编译时通过cross传递环境变量 #

执行cross build时，用--env参数显式传递PROTOC变量，确保它在编译容器中生效：

cross build --target aarch64-unknown-linux-gnu --env PROTOC=/usr/bin/protoc

方案3：通过Cross.toml配置全局环境变量 #

在项目根目录创建或修改Cross.toml文件，添加目标平台的环境变量配置：

[target.aarch64-unknown-linux-gnu]
env = { PROTOC = "/usr/bin/protoc" }

保存后重新执行编译。

方案4：在build.rs中手动指定protoc路径 #

修改common/protos/build.rs，在prost-build的配置中手动指定protoc路径：

use prost_build;

fn main() {
    // 优先读取环境变量，否则使用默认路径
    let protoc_path = std::env::var("PROTOC").unwrap_or("/usr/bin/protoc".to_string());
    
    prost_build::Config::new()
        .protoc_path(protoc_path)
        .compile_protos(&["proto/kv_service.proto"], &["proto"])
        .expect("Failed to compile protos");
}

修改后重新执行编译。

验证方法 #

可以通过以下命令验证编译容器中是否能正确找到protoc：

# 检查protoc路径
cross run --target aarch64-unknown-linux-gnu -- which protoc
# 检查环境变量
cross run --target aarch64-unknown-linux-gnu -- echo $PROTOC

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