Python多阶段Docker构建本地包报ModuleNotFoundError问题咨询

• 可编辑安装的软连接失效：你在requirements.txt中使用pip install -e（可编辑模式）安装本地包时，pip不会将包源码复制到虚拟环境的site-packages目录，仅会生成指向构建阶段本地package/目录的软链接。最终镜像中没有对应路径的package/目录，软链接指向无效。
• 虚拟环境未复制到最终镜像：当前最终镜像的Dockerfile配置中，完全没有从python-builder阶段拷贝编译好的虚拟环境目录的步骤，安装的所有依赖（包括自定义包）根本没有进入最终运行环境。
• 跨基础镜像的潜在兼容问题：构建阶段使用Debian系的python:3.10基础镜像，最终运行阶段使用musl libc的alpine镜像，即使拷贝了虚拟环境，包含二进制扩展的Python包也可能因为libc不兼容无法正常加载。
• 未创建目标用户：最终镜像直接使用USER app_user，但没有提前创建该用户的步骤，会导致权限异常，也会影响虚拟环境的访问。

• 调整本地包安装模式
  修改requirements.txt，去掉自定义包前的-e参数，直接写本地包路径即可，比如将-e ./package改为./package。这种安装模式会将包完整复制到虚拟环境的site-packages目录，无需依赖原源码路径。
• 拷贝构建好的虚拟环境到最终镜像
  在最终镜像的Dockerfile中新增虚拟环境拷贝步骤，且保持路径和构建阶段完全一致，同时提前创建app_user用户并配置权限：

# 在USER指令前新增以下内容
RUN adduser -D app_user
RUN mkdir -p /home/app_user/venv /home/app_user/code
COPY --from=python-builder /home/app_user/venv /home/app_user/venv
RUN chown -R app_user:app_user /home/app_user

• 统一基础镜像版本（可选但推荐）
  将构建阶段的基础镜像替换为和最终镜像一致的python:3.10-alpine3.14，避免二进制依赖的兼容问题：

# 替换python-builder阶段的基础镜像
FROM python:3.10-alpine3.14 AS python-builder

• 验证配置
  构建后可进入容器执行pip list查看自定义包是否正常安装，执行python -c "import package"验证模块导入是否正常。

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