Github Actions中Django模块找不到问题排查求助

开发者阿泽

2026-6-16

排查思路

以下是针对该问题的具体排查方向：

验证pip与python的对应关系
在CI流水线中添加调试步骤，输出以下命令的结果：
```
which pip
which python
pip --version
python -m pip --version
```
对比输出结果，确认pip指向的Python版本是否与python命令一致。如果两者版本不同（比如pip对应Python3.10，而python是3.11），说明PATH中优先找到的是旧版本的pip，导致安装的依赖不在当前Python环境的site-packages目录下。
锁定容器镜像的具体版本
python:3.11-slim是滚动更新的标签，上周和本周的镜像内容可能存在差异。将镜像指定为具体的版本tag（例如python:3.11.8-slim，可从Docker Hub查询对应版本），重新运行CI，确认是否是镜像更新导致的环境路径变化。
检查依赖安装的目标路径
在执行pip install后，添加步骤查看已安装包的位置：
```
pip show django  # 若安装成功的话
python -c "import sys; print(sys.path)"
```
对比python -m pip show django的输出，确认依赖是否被安装到了当前Python解释器能识别的路径中。如果路径不匹配，说明直接使用pip时安装到了错误的环境。
排查CI步骤中的环境变量或虚拟环境问题
检查流水线中是否有修改PATH环境变量的步骤，或者是否使用了虚拟环境（venv/virtualenv）。如果使用了虚拟环境，确认是否正确激活——直接调用pip可能未使用虚拟环境内的pip，而python -m pip会强制使用当前Python解释器对应的pip。
确认pip命令的别名/脚本指向
部分系统中pip可能是一个别名或脚本，指向其他版本的pip。通过pip --version的输出可以直接确认其关联的Python版本，若版本不符，说明需要改用pip3.11或python -m pip来确保使用正确的包管理工具。