Express.js Docker容器运行Python报模块找不到的解决方法

当前Dockerfile存在两个核心缺陷，直接触发Python模块导入报错：

• 基础镜像node:18仅预装了Python3运行时，未安装Python侧的第三方依赖。本地运行正常是因为本地开发环境提前安装了pyecma376_2等依赖，容器是全新隔离环境，没有预装这些第三方包，自然触发ModuleNotFoundError。
• 容器内Python运行时的模块搜索路径未覆盖自有代码assi的存放目录。本地运行时工作目录、环境变量配置刚好匹配Python搜索规则，容器内启动路径、工作目录上下文和本地存在差异，无法扫描到自定义的assi模块。

直接调整Dockerfile，补全Python环境配置与路径声明即可，参考配置如下：

FROM node:18

# 安装pip用于管理Python依赖，清理apt缓存减小镜像体积
RUN apt update && apt install -y python3-pip && rm -rf /var/lib/apt/lists/*

WORKDIR /usr/src/app

# 优先拷贝依赖清单，复用Docker构建缓存
COPY package*.json ./
# 存在Python依赖清单requirements.txt时放开下一行注释
# COPY requirements.txt ./

# 安装Node侧依赖
RUN npm install
# 安装Python第三方依赖：如果不用requirements.txt，直接在后面拼接其他需要的包名即可
RUN pip3 install --no-cache-dir pyecma376_2

# 拷贝全量项目代码
COPY . .

# 将自定义Python模块的父目录加入Python搜索路径
# 注意：路径为assi文件夹所在的父目录，不是assi文件夹本身，按实际目录结构调整
# 示例中assi路径为/usr/src/app/public/pythonscripts/myPython/assi，因此父目录为下述路径
ENV PYTHONPATH="${PYTHONPATH}:/usr/src/app/public/pythonscripts/myPython"

EXPOSE 3001
CMD ["node", "./bin/www"]

校验注意事项 #

• 若选择使用requirements.txt管理Python依赖，可在本地项目根目录执行pip3 freeze > requirements.txt导出本地已安装的依赖清单，确保清单包含pyecma376_2等必需包。
• 检查项目根目录的.dockerignore文件，确认未排除Python代码目录、requirements.txt等必要文件，避免构建时文件漏拷贝。
• 容器启动后可通过docker exec -it <容器ID> /bin/bash进入容器，执行python3 -c "import sys; print(sys.path)"查看Python搜索路径是否包含自定义模块目录，执行pip3 list确认第三方依赖是否安装成功。

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