交叉编译Rust应用时Linker无法找到libpq库的解决求助

问题原因 #

Cross工具依赖Docker容器完成交叉编译，你本地安装的libpq-dev是x86架构的glibc版本，无法适配armv7-unknown-linux-musleabi的容器环境。同时Cross默认镜像中没有对应架构、适配musl标准库的libpq库，导致链接器报错cannot find -lpq。

解决方案一：静态编译libpq（推荐） #

给pq-sys添加static特性，让它自动下载并编译静态版本的libpq，彻底摆脱对系统库的依赖：

1. 修改Cargo.toml中的pq-sys依赖配置：

pq-sys = { version = "0.4.7", features = ["static"] }

2. 重新执行交叉编译命令：

cross build --target armv7-unknown-linux-musleabi

该特性会让pq-sys从源码编译静态链接的libpq，完全不依赖系统中的动态库，直接解决交叉编译环境下的库适配问题。

解决方案二：自定义Cross构建镜像 #

如果需要使用系统库版本的libpq，可以自定义Docker镜像，在Cross的构建容器中安装armv7-musleabi架构的libpq：

1. 在项目根目录创建Cross.toml配置文件：

[target.armv7-unknown-linux-musleabi]
dockerfile = "Dockerfile.cross"

2. 同目录创建Dockerfile.cross，基于Cross基础镜像编译musl版本的libpq：

FROM rustembedded/cross:armv7-unknown-linux-musleabi

# 安装编译依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    wget \
    tar \
    make \
    gcc-arm-linux-musleabi

# 下载并编译PostgreSQL（仅安装libpq组件）
RUN wget https://ftp.postgresql.org/pub/source/v15.3/postgresql-15.3.tar.gz && \
    tar -xzf postgresql-15.3.tar.gz && \
    cd postgresql-15.3 && \
    ./configure --host=arm-linux-musleabi --prefix=/usr/arm-linux-musleabi \
        --without-readline --without-zlib --enable-static --disable-shared && \
    make -j$(nproc) && \
    make install && \
    cd .. && \
    rm -rf postgresql-15.3 postgresql-15.3.tar.gz

# 设置环境变量，让pq-sys定位到编译好的库
ENV PQ_LIB_DIR=/usr/arm-linux-musleabi/lib
ENV PQ_INCLUDE_DIR=/usr/arm-linux-musleabi/include

3. 重新执行交叉编译命令：

cross build --target armv7-unknown-linux-musleabi

额外注意事项 #

• 使用解决方案二时，可根据需求替换命令中的PostgreSQL版本号（示例中为15.3）。
• 确保Docker服务处于运行状态，Cross会自动构建自定义镜像并完成编译。

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