Docker容器中pytest未加载conftest.py无法识别自定义参数问题

核心排查方向 #

pytest加载conftest.py的逻辑是固定的：从传入的测试文件路径所在目录开始，向上递归查找所有父目录下的conftest.py，同时加载执行命令时工作目录下的conftest配置。本地运行正常、Docker内加载失败，基本都是路径、文件命名、工作目录配置不一致导致的，优先排查以下问题：

• 检查conftest文件命名：你给出的目录结构中src/test/regression/下的配置文件名写的是conftest，确认是否漏写.py后缀，pytest仅会识别完整命名为conftest.py的配置文件，无后缀文件不会被加载。
• 检查路径拼写一致性：你调用pytest时传入的测试文件路径是src/tests/regression/regression_tests.py，但给出的目录结构里测试根目录是src/test/（路径少了末尾的s），本地环境可能因为软链接、IDE路径缓存不报错，但Docker环境是严格路径匹配，路径写错会直接导致pytest找不到测试文件目录，自然不会加载对应位置的conftest。
• 检查Docker内工作目录配置：如果Dockerfile中WORKDIR配置的不是项目根目录（即可直接看到src文件夹的层级），或者启动容器时挂载项目的路径层级不对，硬编码的相对路径会指向不存在的位置，直接导致配置加载失败。
• 检查pytest版本一致性：如果本地和Docker镜像内安装的pytest大版本差异过大，也可能出现conftest加载逻辑的差异，建议在依赖文件中固定pytest版本，保证两边环境一致。

可落地修复方案 #

1. 先修复基础错误
   补全conftest的.py后缀，对齐测试文件路径的拼写，确保代码中写的路径和实际目录结构完全一致。
2. 用绝对路径+显式指定rootdir，彻底规避工作目录差异影响
   不要在pytest调用中硬编码相对路径，通过当前文件位置动态计算项目根目录的绝对路径，同时传入--rootdir参数强制pytest从指定根目录开始查找配置，修改后的调用代码参考：

   import os
   def _invoke_pytest(self):
       # 从当前invoke_pytest文件所在位置向上溯源，拿到项目根目录的绝对路径
       # 可根据你的文件实际层级调整向上跳转的次数
       project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), "../../"))
       test_file_path = os.path.join(project_root, "src/test/regression/regression_tests.py")
       pytest.main([
           test_file_path,
           "-m", self.expectations_suite,
           "--sample", self.sample_filepath,
           "--expectations", self.expectations_suite_filepath,
           "--report-log", self.logs_report_filepath,
           f"--rootdir={project_root}"  # 显式指定pytest根目录，避免路径搜索偏差
       ])
   

3. 校验容器内目录结构
   在Dockerfile构建步骤或者容器启动脚本中加入ls -R 你的项目存放路径命令，构建/启动时直接打印目录结构，确认所有代码文件（包括conftest.py）都被正确拷贝、挂载到容器内的对应位置，没有出现文件遗漏、层级错位的问题。
4. 加调试日志快速定位
   调用pytest时加上-v（详细输出）参数，运行日志会直接打印pytest识别到的conftest路径、搜索配置的目录范围，如果还是加载失败可以直接根据日志输出的搜索路径定位偏差点。

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