GitLab流水线报ImportError找不到libmagic，本地Mint环境运行正常

问题根源 #

你的Docker镜像里缺了系统级的libmagic依赖库。Python的python-magic只是封装层，实际运行需要系统层面提供libmagic库文件——本地Mint和伙伴的环境自带这个库，所以没问题，但Alpine Linux镜像默认没有，之前分支没用到libmagic所以没暴露问题，这次修改后就触发了报错。

注意：你通过poetry安装的libmagic是Python包，它同样依赖系统级的libmagic库，不能替代系统包。

修复步骤 #

修改Dockerfile中的系统依赖安装命令，添加Alpine提供libmagic的包：

RUN echo "====== System dependencies ======" && \
    apk update && \
    apk add --no-cache postgresql-libs file && \
    apk add --no-cache postgresql-dev file-dev && \
    apk add --no-cache python3-dev py3-setuptools py3-virtualenv musl-dev gcc libffi-dev libxml2-dev \
                       libxml2 g++ libxslt-dev libuv make zlib-dev jpeg-dev git \
                       libressl-dev openssl libzmq zeromq-dev util-linux bash curl

• file：包含运行时所需的libmagic库文件
• file-dev：包含编译时所需的头文件，确保Python包能正确链接到系统库

验证 #

重新构建Docker镜像后，GitLab流水线的测试命令应该能正常加载magic模块，不会再出现ImportError。

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