GitLab CI/CD中pandahouse库安装失败问题求助

问题根源 #

你使用的python:3-alpine是轻量级镜像，默认缺少编译Python扩展所需的系统依赖（如GCC编译器、musl开发库等）。pandahouse安装过程中需要编译部分底层组件，缺少这些依赖就会触发包元数据生成失败的错误。

可行解决方案 #

方案1：替换为标准Python镜像 #

Alpine镜像的兼容性短板在这里很明显，换成非Alpine的标准Python镜像（比如slim版本或完整版），可以直接跳过编译依赖的问题：

image: python:3.10-slim  # 替换原有的python:3-alpine

stages:
    - build
    - test
    - deploy

send_info:
    stage: test
    before_script:
    - pip3 install sphinx  
    script:
        - pip install --upgrade pip
        # 合并多个pip命令，提升执行效率
        - pip install seaborn openpyxl pandas pyTelegramBotAPI Python-IO matplotlib pandahouse
        - echo 'Hello'
        - python bot_test2.py

注：新版本pip的依赖解析器已经足够稳定，可以移除--use-deprecated=legacy-resolver参数

方案2：在Alpine镜像中补全编译依赖 #

如果必须保留Alpine镜像，先安装编译所需的系统依赖再装Python库：

image: python:3-alpine

stages:
    - build
    - test
    - deploy

send_info:
    stage: test
    before_script:
    # 安装编译依赖，--no-cache避免缓存占用空间
    - apk add --no-cache gcc musl-dev
    - pip3 install sphinx  
    script:
        - pip install --upgrade pip --use-deprecated=legacy-resolver
        - pip install auxlib --use-deprecated=legacy-resolver
        - pip install seaborn openpyxl pandas pyTelegramBotAPI Python-IO matplotlib pandahouse --use-deprecated=legacy-resolver
        - echo 'Hello'
        - python bot_test2.py

方案3：用requirements.txt简化配置 #

把所有依赖写入requirements.txt文件，让CI配置更简洁易维护：

# requirements.txt
sphinx
seaborn
openpyxl
pandas
pyTelegramBotAPI
Python-IO
matplotlib
pandahouse

修改后的CI配置：

image: python:3.10-slim

stages:
    - build
    - test
    - deploy

send_info:
    stage: test
    script:
        - pip install --upgrade pip
        - pip install -r requirements.txt
        - echo 'Hello'
        - python bot_test2.py

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