为armv7交叉编译Rust的alsa crate遇pkg-config错误求助

问题背景 #

我正尝试为armv7-unknown-linux-gnueabihf架构交叉编译一个基于alsa crate的Rust二进制文件，使用Cross工具配合自定义Dockerfile获取依赖，但编译时pkg-config提示找不到alsa库。

当前配置 #

自定义Dockerfile #

FROM ghcr.io/cross-rs/armv7-unknown-linux-gnueabihf:0.2.5

RUN dpkg --add-architecture armhf && \
    apt-get update && \
    apt-get install -y --no-install-recommends \
        libasound2-dev:armhf \
        libudev-dev:armhf \
        pkg-config:armhf

RUN apt-get autoremove -y && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

COPY .cargo/config.toml /root/.cargo/config.toml

.cargo/config.toml配置 #

[build]

[target.arm-unknown-linux-gnueabihf.libasound]
linker = "arm-linux-gnueabihf-gcc"
rustc-link-lib = ["libasound"]
rustc-link-search = ["/usr/lib/arm-linux-gnueabihf"]

编译错误信息 #

执行命令：cross build --target armv7-unknown-linux-gnueabihf --features "alsa-backend" -v 后出现以下错误：

error: failed to run custom build command for `alsa-sys v0.3.1`

Caused by:
  process didn't exit successfully: `/target/debug/build/alsa-sys-5b7e484eb5de5d94/build-script-build` (exit status: 101)
  --- stderr
  thread 'main' panicked at '`PKG_CONFIG_ALLOW_SYSTEM_CFLAGS="1" PKG_CONFIG_ALLOW_SYSTEM_LIBS="1" PKG_CONFIG_PATH="/usr/lib/arm-linux-gnueabihf/pkgconfig/" "pkg-config" "--libs" "--cflags" "alsa"` did not exit successfully: exit status: 2
  error: could not find system library 'alsa' required by the 'alsa-sys' crate

  --- stderr
  /usr/bin/pkg-config: 1: /usr/bin/pkg-config: Syntax error: word unexpected (expecting ")")
  ', /cargo/registry/src/index.crates.io-6f17d22bba15001f/alsa-sys-0.3.1/build.rs:13:18

已尝试的方法 #

• 添加alsa-backend特性标志
• 配置自定义的.cargo/config.toml文件
• 查阅相关Stack Overflow帖子但未找到有效方案

解决思路 #

1. 修复pkg-config架构不匹配问题 #

错误中的Syntax error: word unexpected是核心问题：你安装了armhf架构的pkg-config，但Cross容器是x86_64架构的，直接运行armhf二进制会报错。需保留x86_64版本的pkg-config，同时配置它指向armhf的库。

修改Dockerfile：

FROM ghcr.io/cross-rs/armv7-unknown-linux-gnueabihf:0.2.5

RUN dpkg --add-architecture armhf && \
    apt-get update && \
    apt-get install -y --no-install-recommends \
        libasound2-dev:armhf \
        libudev-dev:armhf \
        pkg-config  # 安装x86_64原生版本的pkg-config

RUN apt-get autoremove -y && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

# 设置pkg-config环境变量，指定armhf库路径
ENV PKG_CONFIG_PATH="/usr/lib/arm-linux-gnueabihf/pkgconfig"
ENV PKG_CONFIG_ALLOW_CROSS=1
ENV PKG_CONFIG_SYSROOT_DIR="/"

COPY .cargo/config.toml /root/.cargo/config.toml

2. 修正.cargo/config.toml的目标架构 #

配置中目标架构为arm-unknown-linux-gnueabihf，与实际编译目标armv7-unknown-linux-gnueabihf不匹配，需统一：

[build]

[target.armv7-unknown-linux-gnueabihf.libasound]
linker = "arm-linux-gnueabihf-gcc"
rustc-link-lib = ["asound"]  # 无需前缀lib，Rust会自动添加
rustc-link-search = ["/usr/lib/arm-linux-gnueabihf"]

3. 强制alsa-sys跳过pkg-config（备选方案） #

若上述方法无效，可设置环境变量让alsa-sys不依赖pkg-config，直接使用配置的链接参数：

ALSA_NO_PKG_CONFIG=1 cross build --target armv7-unknown-linux-gnueabihf --features "alsa-backend" -v

4. 清理Cross缓存后重新构建 #

清理Cross和Docker缓存，避免旧镜像干扰：

cross clean
docker system prune -f

之后重新执行编译命令。

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