unittest.mock.patch模块与函数区分问题及跨版本兼容方案

1. 项目命名确实存在问题 #

你遇到的核心问题是模块名与__init__.py中导出的函数名同名，导致Python解析my_package.load_data时出现歧义：

• Python 3.12的模块查找优先级或导入解析逻辑有调整，优先识别到load_data.py模块；
• Python 3.10则优先读取__init__.py中已导入的同名函数，自然找不到load_data_from_provider属性。

这种同名设计本身违反了Python导入的清晰性原则，容易引发版本兼容问题，建议优先调整命名：

• 方案1：将load_data.py模块重命名为data_loader.py或其他不冲突的名称；
• 方案2：将__init__.py中导入的函数改名为load_data_func或fetch_data等，避免与模块名重复。

2. 可以明确指定打桩目标为模块 #

不需要依赖字符串路径的模糊解析，直接通过模块对象精准指定打桩目标，完全规避版本差异：

• 先直接导入目标模块（而非从__init__导入），再用@patch.object()装饰器打桩模块内的函数：

import my_package.load_data  # 直接导入模块，不受__init__.py中同名函数影响
from unittest.mock import patch

@patch.object(my_package.load_data, "load_data_from_provider")
def test_load_data_from_provider(mock_func):
    # 测试逻辑示例
    mock_func.return_value = {"key": "value"}
    # 调用被测试的代码
    # 断言mock的调用情况
    pass

这种方式直接绑定模块对象的属性，不管Python版本如何，都能精准定位到load_data.py中的load_data_from_provider函数。

3. 多Python版本兼容的可行方案 #

如果暂时无法修改命名，除了上述patch.object的方式，还可以用以下两种兼容方案：

• 方案A：动态导入模块
  用importlib动态导入模块，避免静态导入的歧义：

  import importlib
  from unittest.mock import patch
  
  load_data_module = importlib.import_module("my_package.load_data")
  
  @patch.object(load_data_module, "load_data_from_provider")
  def test_load_data(mock_func):
      # 测试逻辑
      pass
  

• 方案B：使用create=True参数（应急方案）
  若必须使用字符串路径，可添加create=True强制创建属性（仅适用于属性不存在的场景，优先级低于模块对象方式）：

  @patch("my_package.load_data.load_data_from_provider", create=True)
  def test_load_data(mock_func):
      # 测试逻辑
      pass
  

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