在Alpine3.16.2+Python3.8环境安装Aerospike4.0.0遇符号缺失错误

问题重现 #

在Alpine 3.16.2 + Python 3.8.14环境中安装Aerospike 4.0.0：

1. 已编译aerospike-client-c 4.6.18（指定EVENT_LIB=libuv）
2. 通过pip完成Aerospike Python客户端安装
3. 执行python3 -c 'import aerospike'时抛出错误：

ImportError: Error relocating /usr/local/lib/python3.8/site-packages/aerospike.cpython-38-x86_64-linux-gnu.so: uv_async_send: symbol not found

提供的Dockerfile如下：

ARG PYTHON_VERSION=3.8

FROM python:${PYTHON_VERSION}-alpine as aerospike-c-builder
ENV AS_C_VERSION=4.6.18
WORKDIR /src

RUN apk update
RUN apk add --no-cache \
    build-base \
    bash linux-headers \
    libuv libuv-dev \
    openssl openssl-dev \
    lua5.1 lua5.1-dev zlib-dev
RUN wget https://artifacts.aerospike.com/aerospike-client-c/${AS_C_VERSION}/aerospike-client-c-src-${AS_C_VERSION}.zip \
    && unzip aerospike-client-c-src-${AS_C_VERSION}.zip \
    && mv aerospike-client-c-src-${AS_C_VERSION} aerospike-client-c \
    && cd aerospike-client-c \
    && make EVENT_LIB=libuv


# Stage 2: Build Aerospike Python client
FROM python:${PYTHON_VERSION}-alpine as aerospike-python-builder
ENV AS_PYTHON_VERSION=4.0.0
WORKDIR /src
COPY --from=aerospike-c-builder /src/aerospike-client-c/target/Linux-x86_64/ aerospike-client-c/

ENV PREFIX=/src/aerospike-client-c/
RUN apk update
RUN apk add --no-cache \
    build-base \
    bash \
    linux-headers \
    zlib-dev \
    openssl-dev \
    git
ENV DOWNLOAD_C_CLIENT 0
RUN pip --no-cache-dir install aerospike==${AS_PYTHON_VERSION}

问题原因 #

错误本质是动态链接库依赖不匹配：

• Alpine使用musl libc，编译aerospike-client-c时默认依赖系统动态libuv，多阶段构建的第二阶段未正确同步该依赖，或libuv版本与编译时不一致
• 动态链接的libuv符号未被打包进Python客户端扩展，导致运行时无法找到

解决步骤 #

1. 修改C客户端构建阶段：静态编译libuv并链接 #

在aerospike-c-builder阶段，放弃系统libuv，转而编译静态版libuv并让C客户端静态链接，彻底消除动态依赖：

FROM python:${PYTHON_VERSION}-alpine as aerospike-c-builder
ENV AS_C_VERSION=4.6.18
WORKDIR /src

RUN apk update
RUN apk add --no-cache \
    build-base \
    bash linux-headers \
    openssl openssl-dev \
    lua5.1 lua5.1-dev zlib-dev
# 下载并编译C客户端，同时编译静态libuv
RUN wget https://artifacts.aerospike.com/aerospike-client-c/${AS_C_VERSION}/aerospike-client-c-src-${AS_C_VERSION}.zip \
    && unzip aerospike-client-c-src-${AS_C_VERSION}.zip \
    && mv aerospike-client-c-src-${AS_C_VERSION} aerospike-client-c \
    && cd aerospike-client-c \
    # 编译静态libuv
    && ./install_libuv --static \
    # 静态链接libuv编译C客户端
    && make EVENT_LIB=libuv USE_STATIC_LIBUV=1

2. 修改Python客户端构建阶段：指定静态链接参数 #

在aerospike-python-builder阶段，设置LDFLAGS强制pip安装时链接静态库，确保所有依赖符号被打包进Python扩展：

FROM python:${PYTHON_VERSION}-alpine as aerospike-python-builder
ENV AS_PYTHON_VERSION=4.0.0
WORKDIR /src
COPY --from=aerospike-c-builder /src/aerospike-client-c/target/Linux-x86_64/ aerospike-client-c/

ENV PREFIX=/src/aerospike-client-c/
RUN apk update
RUN apk add --no-cache \
    build-base \
    bash \
    linux-headers \
    zlib-dev \
    openssl-dev \
    git
ENV DOWNLOAD_C_CLIENT=0
# 配置链接参数，强制静态链接Aerospike和libuv库
ENV LDFLAGS="-L${PREFIX}/lib -Wl,-Bstatic -lavm -laerospike -luv -Wl,-Bdynamic -lpthread -ldl -lz -lcrypto"
RUN pip --no-cache-dir install aerospike==${AS_PYTHON_VERSION}

3. 验证 #

构建镜像后，运行容器执行以下命令，无报错则说明问题解决：

python3 -c 'import aerospike; print("Aerospike imported successfully")'

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