Docker容器安装pgpy后导入失败：ImportError: No module named pgpy

1. 验证pip安装路径与Python运行路径匹配度 #

• 执行pip3 show pgpy查看模块安装的具体位置（关注输出里的Location字段）
• 执行python3 -c "import sys; print(sys.path)"查看Python的模块搜索路径列表
• 确认pgpy的安装目录在sys.path列表内，若不在，说明当前使用的pip3和python3不属于同一环境（比如容器内存在多版本Python）

2. 检查别名设置的有效性 #

• 交互式shell的alias命令在非交互式环境（如Dockerfile的RUN指令、容器启动脚本）中不会生效，仅用alias pip=pip3和alias python=python3可能无法解决环境统一问题
• 推荐两种替代方案：
  • 脚本内直接使用python3和pip3，避免依赖别名
  • 通过系统工具设置默认版本：

    RUN update-alternatives --install /usr/bin/python python /usr/bin/python3 100
    RUN update-alternatives --install /usr/bin/pip pip /usr/bin/pip3 100
    

3. 检查Dockerfile构建顺序与缓存问题 #

• 若pip3 install pgpy步骤在复制decryption.py之后，Docker缓存机制可能导致模块未安装到最新镜像层
• 调整Dockerfile顺序，先完成依赖安装再复制代码：

  # 先安装Python及pip3
  RUN apt-get update && apt-get install -y python3 python3-pip
  # 安装pgpy模块
  RUN pip3 install pgpy
  # 最后复制业务代码
  COPY decryption.py .
  

4. 排查非root用户的权限问题 #

• 若容器以非root用户运行，可能无权限访问pgpy的系统级安装目录
• 可指定安装到用户私有目录：

  RUN pip3 install --user pgpy
  

  同时确保运行脚本的用户能访问~/.local/lib/pythonX.X/site-packages目录

5. 确认Python版本兼容性 #

• pgpy对Python版本有要求（当前支持Python3.7+），node:16镜像自带的Python3版本可能过低
• 执行python3 --version查看版本，若版本不满足需升级容器内的Python3

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