Docker容器中Python项目遇'magic'模块未找到错误求助

针对Windows 10上Docker容器运行依赖python-magic的Python项目时遇到的报错问题，给出以下具体解决思路：

1. 拆分跨平台依赖，避免Windows/Linux冲突 #

python-magic-bin是专为Windows打包的预编译版本（内置libmagic二进制文件），但在Linux容器环境下完全不需要这个包，反而会因为二进制不兼容导致模块找不到。你需要在requirements.txt中区分环境指定依赖：

# Windows环境用python-magic-bin
python-magic-bin>=0.4.27; sys_platform == 'win32'
# Linux容器环境用python-magic
python-magic>=0.4.27; sys_platform != 'win32'

这样本地Windows开发装python-magic-bin，容器里自动安装适配Linux的python-magic。

2. 清理Dockerfile中冲突的系统包 #

你当前Dockerfile里安装的python3-magic是系统级Python包，对应容器内系统自带的Python版本，和你使用的官方Python 3.11镜像的pip包路径不兼容，会导致模块查找混乱。修改apt-get install命令，移除python3-magic，只保留底层依赖libmagic1：

RUN apt-get update && apt-get install -y \
    poppler-utils \
    tesseract-ocr \
    libgl1-mesa-glx \
    libmagic1  # 仅保留这个，删除python3-magic

3. 验证容器内依赖安装状态 #

构建镜像并启动容器后，进入容器检查pip安装的包：

docker exec -it <你的容器ID/名称> bash
pip list | grep magic

确认输出是python-magic而非python-magic-bin，如果是后者说明requirements.txt的环境区分逻辑未生效，需检查语法是否正确。

4. 手动指定libmagic路径（可选） #

如果以上步骤后仍报错，可能是python-magic找不到系统的libmagic库文件，可以先进入容器查找libmagic的位置：

find / -name libmagic.so*

通常路径为/usr/lib/x86_64-linux-gnu/libmagic.so.1，然后在Dockerfile的dev和test阶段添加环境变量指定路径：

ENV MAGIC=/usr/lib/x86_64-linux-gnu/libmagic.so.1

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