Docker环境下Django导入sendgrid模块失败该如何解决？

问题解决步骤 #

• 确认报错来源
  首先触发对应的视图请求，确认是Django运行时抛出ModuleNotFoundError，还是仅本地IDE的静态检查提示报错：
  • 如果仅IDE提示，运行时功能正常：是IDE解释器配置错误，将IDE的Python解释器切换为项目对应的pipenv虚拟环境，或配置远程解释器指向Docker容器内的Python环境即可消除提示。
  • 如果运行时确实抛出模块未找到错误，继续往下排查。
• 检查Docker构建相关配置
  1. 检查项目根目录的.dockerignore文件，确认没有配置排除Pipfile、Pipfile.lock的规则，否则本地更新的依赖配置不会被传入容器构建上下文。
  2. 确认Dockerfile中依赖安装的步骤顺序正确，必须先复制依赖配置文件再执行安装，示例配置如下：

     WORKDIR /app
     COPY Pipfile Pipfile.lock ./
     RUN pipenv install --deploy --system
     COPY . .
     

  3. 重新构建镜像时禁用缓存，避免旧的依赖层被复用：

     docker-compose down
     docker-compose build --no-cache web
     docker-compose up -d
     

• 验证Python环境一致性
  分别打印Django Shell和运行时的Python模块搜索路径，确认两者一致：

  # 打印Shell环境的搜索路径
  docker-compose exec web python -c "import sys; print('\n'.join(sys.path))"
  

  临时在views.py的导入语句前添加以下代码，访问视图后查看容器日志输出的路径，和上面的结果对比：

  import sys
  print('\n'.join(sys.path))
  

  如果路径不一致，检查Docker启动命令是否正确使用了pipenv虚拟环境，启动命令需按示例编写：

  pipenv run python manage.py runserver 0.0.0.0:8000
  

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