M1 Mac下用Docker编译静态链接Rust二进制文件因zlib失败

问题背景 #

本地开发时需要编译静态链接的Rust二进制（依赖C语言库如rdkafka），在Intel Mac上运行正常，但M1 Mac上无法生成可用镜像，编译过程中libz-sys构建失败。

配置文件 #

Cargo.toml #

[dependencies]
serde = "1.0.136"
serde_json = "1.0.79"
rdkafka = { version = "0.28.0", features = ["cmake-build"]} # , "ssl", "gssapi-vendored"
tokio = { version = "1.17", features = ["rt-multi-thread", "macros"] }
meilisearch-sdk = "0.17.0"
futures = "0.3.21"
log = "0.4.16"
pretty_env_logger = "0.4.0"
async-trait = "0.1.53"
tonic = "0.7.2"
nats = "0.21.0"
prost = "0.10.4"
lazy_static = "1.4.0"

Dockerfile #

# 使用clux/muslrust编译rdkafka的静态链接C二进制文件
FROM docker.io/clux/muslrust:latest as build

RUN apt-get update && apt-get install gcc-multilib g++ cmake libsasl2-dev build-essential linux-libc-dev zlib1g zlib1g-dev -y
WORKDIR /usr/src

# 下载静态链接目标并添加rustfmt
RUN rustup target add x86_64-unknown-linux-musl  && rustup component add rustfmt

# 编译并安装二进制文件
COPY . .
RUN ln -s /bin/g++ /bin/musl-g++
RUN cargo install --target x86_64-unknown-linux-musl --path .

错误信息 #

Compiling tracing v0.1.37
#18 167.5 <jemalloc>: MADV_DONTNEED 无法工作（将改用memset）
#18 167.5 <jemalloc>:（如果在QEMU下运行，这是预期行为）
#18 171.3 error: 执行`libz-sys v1.1.8`的自定义构建命令失败
#18 171.3 
#18 171.3 原因：
#18 171.3   进程未正常退出：`/usr/src/target/release/build/libz-sys-dc1598b5e3c2b6ab/build-script-build`（退出状态：1）
#18 171.3   --- stdout
#18 171.3   cargo:rerun-if-env-changed=LIBZ_SYS_STATIC
#18 171.3   cargo:rerun-if-changed=build.rs
#18 171.3   TARGET = Some("x86_64-unknown-linux-musl")
#18 171.3   OPT_LEVEL = Some("3")
#18 171.3   HOST = Some("x86_64-unknown-linux-gnu")
#18 171.3   cargo:rerun-if-env-changed=CC_x86_64-unknown-linux-musl
#18 171.3   CC_x86_64-unknown-linux-musl = None
#18 171.3   cargo:rerun-if-env-changed=CC_x86_64_unknown_linux_musl
#18 171.3   CC_x86_64_unknown_linux_musl = None
#18 171.3   cargo:rerun-if-env-changed=TARGET_CC
#18 171.3   TARGET_CC = None
#18 171.3   cargo:rerun-if-env-changed=CC
#18 171.3   CC = Some("musl-gcc")
#18 171.3   cargo:rerun-if-env-changed=CFLAGS_x86_64-unknown-linux-musl
#18 171.3   CFLAGS_x86_64-unknown-linux-musl = None
#18 171.3   cargo:rerun-if-env-changed=CFLAGS_x86_64_unknown_linux_musl
#18 171.3   CFLAGS_x86_64_unknown_linux_musl = None
#18 171.3   cargo:rerun-if-env-changed=TARGET_CFLAGS
#18 171.3   TARGET_CFLAGS = None
#18 171.3   cargo:rerun-if-env-changed=CFLAGS
#18 171.3   CFLAGS = None
#18 171.3   cargo:rerun-if-env-changed=CRATE_CC_NO_DEFAULTS
#18 171.3   CRATE_CC_NO_DEFAULTS = None
#18 171.3   DEBUG = Some("false")
#18 171.3   CARGO_CFG_TARGET_FEATURE = Some("fxsr,llvm14-builtins-abi,sse,sse2")

解决方案 #

1. 强制指定Docker构建平台 #

M1 Mac是ARM架构，Docker默认用QEMU模拟x86_64环境，容易出现兼容性问题。直接指定构建平台为linux/amd64：

• 修改Dockerfile开头：

  FROM --platform=linux/amd64 docker.io/clux/muslrust:latest as build
  

• 或者构建时添加参数：

  docker build --platform linux/amd64 .
  

2. 强制libz-sys静态链接 #

设置环境变量让libz-sys使用静态编译的zlib，避免依赖系统库：
在Dockerfile的cargo install前添加：

ENV LIBZ_SYS_STATIC=1

3. 移除不必要的musl-g++软链接 #

clux/muslrust镜像已经配置好了musl工具链，手动软链接可能导致工具链冲突，删除这一行：

RUN ln -s /bin/g++ /bin/musl-g++

4. 升级rdkafka依赖版本 #

旧版本的rdkafka可能对ARM下的交叉编译支持不好，升级到较新版本（比如0.32.0），同时确认features配置：

rdkafka = { version = "0.32.0", features = ["cmake-build", "static-link"]}

5. 优化构建命令参数 #

在cargo install时添加--locked参数确保依赖版本一致，同时指定--release：

RUN cargo install --locked --release --target x86_64-unknown-linux-musl --path .

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