M1 Pro芯片Mac构建Actix-web Rust Docker镜像遇arm_neon.h编译错误

在搭载M1 Pro芯片的MacBook Pro上构建简单的Actix-web Hello World Rust应用Docker镜像时，出现如下编译错误：

#10 26.01   cargo:warning=15826 | vld1_dup_s8 (const int8_t* __a)
#10 26.01   cargo:warning=      |                          ^
#10 26.01   cargo:warning=/usr/lib/gcc/aarch64-alpine-linux-musl/12.2.1/include/arm_neon.h:9209:1: error: expected ',' or ';' before 'vaddlv_s32'
#10 26.01   cargo:warning= 9209 | vaddlv_s32 (int32x2_t __a)
#10 26.01   cargo:warning=      | ^~~~~~~~~~
#10 26.01   cargo:warning=/usr/lib/gcc/aarch64-alpine-linux-musl/12.2.1/include/arm_neon.h:9216:1: error: expected ',' or ';' before 'vaddlv_u32'
#10 26.01   cargo:warning= 9216 | vaddlv_u32 (uint32x2_t __a)
#10 26.01   cargo:warning=      | ^~~~~~~~~~
#10 26.01   cargo:warning=/usr/lib/gcc/aarch64-alpine-linux-musl/12.2.1/include/arm_neon.h:15833:28: error: expected ';', ',' or ')' before '*' token
#10 26.01   cargo:warning=15833 | vld1_dup_s16 (const int16_t* __a)
#10 26.01   cargo:warning=      |                            ^
#10 26.01   cargo:warning=/usr/lib/gcc/aarch64-alpine-linux-musl/12.2.1/include/arm_neon.h: In function 'vtbl1_s8':
#10 26.01   cargo:warning=/usr/lib/gcc/aarch64-alpine-linux-musl/12.2.1/include/arm_neon.h:15840:28: error: expected ';', ',' or ')' before '*' token

相关代码文件如下：

main.rs #

use actix_web::{get, post, web, App, HttpResponse, HttpServer, Responder};

#[get("/")]
async fn hello() -> impl Responder {
    HttpResponse::Ok().body("Hello world!")
}

#[post("/echo")]
async fn echo(req_body: String) -> impl Responder {
    HttpResponse::Ok().body(req_body)
}

async fn manual_hello() -> impl Responder {
    HttpResponse::Ok().body("Hey there!")
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new()
            .service(hello)
            .service(echo)
            .route("/hey", web::get().to(manual_hello))
    })
    .bind(("127.0.0.1", 8080))?
    .run()
    .await
}

Cargo.toml #

[package]
name = "alt-server"
version = "0.1.0"
edition = "2021"

[dependencies]
actix-web = "4"

Dockerfile #

# build stage
FROM rust:1.69.0-alpine3.17 as builder
WORKDIR /app
COPY . /app
RUN rustup default stable
RUN cargo build --release
# RUN cargo build
FROM rust:1.69.0-alpine3.17
LABEL maintainer="jiang@gmail.com"
WORKDIR /app
ENV ROCKET_ADDRESS=0.0.0.0
# ENV ROCKET_PORT=11014
RUN apk update && apk add curl 
#
# only copy the execute file to minimal the image size
# do not copy the release folder
COPY --from=builder /app/target/release/alt-server /app/
CMD ["./alt-server"]

这个错误的核心原因是Alpine Linux的musl libc在ARM64架构下，与GCC的ARM Neon头文件存在兼容性问题，导致编译时无法正确解析Neon指令集相关的函数定义。可以通过以下两种方式解决：

方案一：替换为Debian基础镜像（推荐） #

Alpine的musl libc虽然体积小，但在ARM架构下对某些底层指令集的支持不如glibc完善。改用Debian-based的Rust镜像可以彻底规避这个问题：

修改后的Dockerfile：

# build stage
FROM rust:1.69.0-bullseye as builder
WORKDIR /app
COPY . /app
RUN cargo build --release

# runtime stage
FROM debian:bullseye-slim
LABEL maintainer="jiang@gmail.com"
WORKDIR /app
# 安装必要的运行依赖（curl可选，根据需求保留）
RUN apt-get update && apt-get install -y --no-install-recommends curl \
    && rm -rf /var/lib/apt/lists/*
COPY --from=builder /app/target/release/alt-server /app/
CMD ["./alt-server"]

方案二：保留Alpine镜像，调整编译参数 #

如果坚持使用Alpine镜像，需要补充编译依赖并禁用Neon指令集优化：

修改后的builder阶段：

# build stage
FROM rust:1.69.0-alpine3.17 as builder
WORKDIR /app
COPY . /app
# 添加编译依赖
RUN apk add --no-cache musl-dev gcc
# 禁用Neon特征编译
RUN RUSTFLAGS="-C target-feature=-neon" cargo build --release

注意：此方案会禁用ARM的Neon指令集优化，可能导致应用性能略有下降，仅在必须使用Alpine时考虑。

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