Poetry安装包路径异常导致Django服务器找不到openpyxl问题求助

接手的Django项目采用Poetry进行包管理，本地Docker容器环境中执行poetry add openpyxl和poetry install均正常，但将代码推送到服务器后，执行poetry install系统提示包已安装，运行Django应用却触发内部服务器错误，提示ModuleNotFoundError: No module named 'openpyxl'。

相关配置片段：

• pyproject.toml：

...
[tool.poetry.dependencies]
openpyxl = "^3.0.10"
...

• poetry.lock（openpyxl部分）：

...
[[package]]
name = "openpyxl"
version = "3.0.10"
description = "A Python library to read/write Excel 2010 xlsx/xlsm files"
category = "main"
optional = false
python-versions = ">=3.6"

[package.dependencies]
openpyxl = {version = ">=2.6.0", optional = true, markers = "extra == \"xlsx\""}

[package.extras]
all = ["markuppy", "odfpy", "openpyxl (>=2.6.0)", "pandas", "pyyaml", "tabulate", "xlrd", "xlwt"]
cli = ["tabulate"]
html = ["markuppy"]
ods = ["odfpy"]
pandas = ["pandas"]
xls = ["xlrd", "xlwt"]
xlsx = ["openpyxl (>=2.6.0)"]
yaml = ["pyyaml"]

openpyxl = [
    {file = "openpyxl-3.0.10-py2.py3-none-any.whl", hash = "sha256:0ab6d25d01799f97a9464630abacbb34aafecdcaa0ef3cba6d6b3499867d0355"},
    {file = "openpyxl-3.0.10.tar.gz", hash = "sha256:e47805627aebcf860edb4edf7987b1309c1b3632f3750538ed962bbcc3bd7449"},
]
...

错误提示对应截图：Django内部服务器错误：找不到openpyxl模块

1. 确认Python环境与Poetry虚拟环境匹配 #

• 执行poetry env info查看Poetry当前使用的Python解释器路径，对比Django运行时调用的Python路径是否一致。服务器可能存在多版本Python，Django可能误调用系统默认Python而非Poetry虚拟环境。
• 解决：运行Django前先激活虚拟环境，用poetry run python manage.py runserver启动服务，或通过poetry shell进入虚拟环境后再操作。

2. 检查Poetry安装命令是否遗漏依赖 #

• 服务器执行poetry install时可能添加了--no-root等跳过依赖的参数，导致依赖未实际安装。重新执行完整安装：poetry install --no-interaction --no-ansi。
• 排查是否使用了poetry install --only main这类命令（虽openpyxl属于main分类，但需确认无参数误传）。

3. 修复poetry.lock中的异常自引用配置 #

注意到lock文件中openpyxl存在自引用依赖：openpyxl = {version = ">=2.6.0", optional = true, markers = "extra == \"xlsx\""}，此异常配置会导致安装逻辑混乱。

• 修复步骤：
  1. 本地删除poetry.lock文件和项目内的__pycache__目录。
  2. 重新执行poetry add openpyxl@^3.0.10生成正确的lock文件。
  3. 将新的poetry.lock推送到服务器，再次执行poetry install。

4. 验证虚拟环境中是否真的安装了openpyxl #

• 进入Poetry虚拟环境后执行pip list，查看列表中是否有openpyxl条目。
• 若未找到，手动在虚拟环境中安装：poetry run pip install openpyxl==3.0.10，再验证。

5. 服务器Docker环境排查（若服务器用Docker部署） #

• 检查Dockerfile是否正确执行Poetry安装步骤，需包含：

  COPY pyproject.toml poetry.lock ./
  RUN poetry install --no-root --no-dev
  

• 构建镜像时添加--no-cache参数，避免缓存导致依赖未更新。

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