Docker运行Python应用时psycopg2模块找不到问题求助

问题描述 #

执行命令运行Docker镜像：

docker run -p 5000:5000 api

出现以下错误：

File "/usr/local/lib/python3.8/site-packages/sqlalchemy/dialects/postgresql/psycopg2.py", line 690, in import_dbapi
import psycopg2
ModuleNotFoundError: No module named 'psycopg2'

已确认psycopg2安装在lib目录，但问题仍未解决。

排查与解决步骤 #

• 验证容器内Python环境的模块路径
  启动镜像的交互式shell，检查Python实际加载的模块路径：

  docker run -it --entrypoint /bin/sh api
  

  进入容器后执行：

  python3.8 -c "import sys; print(sys.path)"
  

  确认psycopg2所在的lib目录是否在输出的路径列表中。如果不在，可通过设置PYTHONPATH环境变量添加该路径，或者重新将psycopg2安装到Python的site-packages目录下。

• 修正Dockerfile中的安装逻辑
  若为自定义构建的镜像，调整Dockerfile中的psycopg2安装步骤：

  • 优先使用pip安装psycopg2-binary（避免编译依赖问题），而非系统包管理工具：

    RUN pip install psycopg2-binary
    

  • 确保安装命令在目标Python环境下执行，若使用虚拟环境，需先激活再执行pip安装。

• 清除Docker构建缓存重新构建
  若修改了依赖文件但未生效，构建镜像时跳过缓存：

  docker build --no-cache -t api .
  

• 匹配psycopg2与Python、SQLAlchemy的版本
  Python3.8需搭配兼容的psycopg2版本，可指定版本安装：

  pip install psycopg2-binary==2.9.6
  

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