Docker容器中Python相对导入失效导致Pytest测试报错问题排查求助

首先，我们先聚焦你的导入错误问题，这是导致测试无法运行的核心原因，再结合Docker环境的配置来分析：

一、自定义类导入失败的原因 #

你在测试中使用了相对导入from ..pom.loginpage import LoginPage，但这个写法在pytest+Docker的环境下容易出现路径问题，具体原因如下：

1. 相对导入的层级与Python路径不匹配
   pytest运行测试时，默认会将测试文件所在的目录添加到Python的sys.path中。如果你的测试文件位于类似tests/这样的子目录，而pom目录在项目根目录下，那么..对应的父目录可能并没有被Python识别为模块搜索路径的一部分，导致无法找到pom.loginpage模块。

2. 包结构不完整
   确保pom目录下存在__init__.py文件（可以是空文件），Python需要这个文件来识别该目录为一个可导入的包。虽然Python 3.3+支持无__init__.py的命名空间包，但pytest在处理相对导入时，对标准包的兼容性更好。

3. 绝对导入更适合容器环境
   你的可运行测试代码使用了import Locators这种绝对导入方式，说明Locators所在的目录已经在Python的搜索路径中。相比之下，相对导入对运行环境的目录结构依赖更强，在Docker容器这种隔离环境中更容易出错。

二、Docker容器中运行失败的关联问题 #

除了导入路径，Docker环境的配置也可能加剧这个问题：

1. 容器工作目录未正确设置
   查看你的Dockerfile，是否设置了WORKDIR /code？如果没有，运行pytest时的当前目录可能不是挂载的/code（你的项目根目录），导致Python无法找到pom等模块。

2. PYTHONPATH环境变量未配置
   即使代码挂载到了/code，如果没有将/code添加到PYTHONPATH，Python的模块搜索路径可能不包含项目根目录，从而无法导入pom下的模块。

三、解决方案 #

针对以上问题，你可以按以下步骤修复：

1. 修正导入方式 #

将相对导入改为绝对导入，比如：

from pom.loginpage import LoginPage

这样只要pom所在的项目根目录在Python路径中，就能成功导入。

2. 完善包结构 #

在pom目录下创建空的__init__.py文件：

touch pom/__init__.py

3. 调整Docker配置 #

• 在Dockerfile中添加以下配置，确保工作目录和Python路径正确：

  WORKDIR /code
  ENV PYTHONPATH=/code
  

• 确保运行pytest时是从项目根目录执行，比如在Docker容器中运行的命令为：

  pytest tests/
  

  而不是进入tests目录后再运行pytest。

4. 验证模块路径 #

如果还是有问题，可以在测试脚本开头添加以下代码，打印Python的模块搜索路径，确认项目根目录是否在其中：

import sys
print(sys.path)

运行后查看输出，若/code不在列表中，说明需要调整PYTHONPATH或工作目录。

内容的提问来源于stack exchange，提问作者Виталий Агарев