python-alpine镜像Docker安装google-cloud-bigquery报错解决方法

python:3.10-alpine基础镜像基于musl libc实现，默认不携带C/C++编译工具链，而google-cloud-bigquery的核心依赖（包括grpcio、protobuf、pyarrow等）未提供适配alpine musl环境的预编译二进制wheel包，pip安装时会触发本地源码编译流程，缺少对应前置组件就会直接报错。

安装该依赖前需要先通过apk安装以下两类组件：

• 基础编译工具链：gcc、g++、musl-dev、linux-headers、make、cmake，用于编译Python C扩展源码
• 依赖的系统开发库：openssl-dev、zlib-dev、c-ares-dev、re2-dev、libffi-dev，为grpcio等组件提供编译期依赖的头文件和链接库

FROM python:3.10-alpine

# 安装前置系统依赖，--no-cache参数避免缓存apk索引减小镜像体积
RUN apk add --no-cache \
    gcc \
    g++ \
    musl-dev \
    linux-headers \
    make \
    cmake \
    openssl-dev \
    zlib-dev \
    c-ares-dev \
    re2-dev \
    libffi-dev

# 可选优化：pyarrow编译耗时极长，可直接引入alpine edge测试源的预编译包跳过编译
# RUN apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/testing pyarrow pyarrow-dev

# 安装Python依赖，--no-cache-dir避免缓存pip安装包减小镜像体积
RUN pip3 install --no-cache-dir google-cloud-bigquery

WORKDIR /home
COPY *.py /home/
ENTRYPOINT ["python3", "-u", "myscript.py"]

如果没有强需求必须使用alpine镜像，直接替换基础镜像为python:3.10-slim即可，该版本基于glibc，PyPI上的google-cloud-bigquery及所有依赖都提供预编译的manylinux wheel，无需安装任何编译工具链，直接执行pip安装命令就不会报错，整体安装速度更快，镜像体积也不会明显增大。

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