自动化测试中多独立Python包模块导入冲突问题求助

问题原因拆解 #

• 问题1：找不到subpackage
  手动运行server_one.py时，Python自动将脚本所在的package1目录加入sys.path，因此内部import subpackage能正常找到模块；但从tests目录执行测试时，package1不在sys.path中，Python会将subpackage当作顶级模块查找，导致ModuleNotFoundError。

• 问题2：跨包导入混淆
  把项目根目录加入sys.path后，config.logging_system.logging_config被视为顶级包路径，Python会按sys.path顺序优先找到先出现的config目录（比如package1下的），导致package2错误导入了package1的模块，引发ImportError。

针对性解决方法 #

方法1：统一使用绝对导入（推荐） #

1. 修改服务内部导入语句
   将package1和package2内部的导入全部改为基于项目根的绝对路径：

   • package1/server_one.py中，把import subpackage改为：

     from package1.subpackage import something
     

   • package1/server_one.py中导入日志模块改为：

     from package1.config.logging_system.logging_config import Logger
     

   • package2下的文件做同样修改，确保所有内部导入都明确指定所属包。

2. 测试文件中添加项目根路径
   在每个测试文件开头添加代码，将项目根目录加入sys.path最前端：

   import sys
   from pathlib import Path
   
   # 定位项目根目录（PROJECT文件夹）
   project_root = Path(__file__).parent.parent
   sys.path.insert(0, str(project_root))
   
   # 之后即可正常导入
   from package1.server_one import ServerOne
   from package2.server_two import ServerTwo
   

方法2：使用相对导入避免重名冲突 #

如果不想大规模修改绝对导入，可在服务内部使用相对导入指定当前包：

• package2/server_two.py中导入日志模块改为：

  from .config.logging_system.logging_config import Logger
  

  这里的.表示相对于当前package2目录，确保只加载本包内的config模块，不会和package1的同名模块混淆。

方法3：通过环境变量指定Python路径（可选） #

运行测试前，先设置PYTHONPATH环境变量指向项目根目录，无需在测试文件中修改sys.path：

• Linux/macOS：

  export PYTHONPATH=/path/to/PROJECT
  python3 tests/test_one.py
  

• Windows（PowerShell）：

  $env:PYTHONPATH = "C:\path\to\PROJECT"
  python3 .\tests\test_one.py
  

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