如何在Pytest测试中正确对Python本地导入模块的类方法进行Monkeypatch？

我来帮你一步步搞定这个问题，你遇到的两个核心问题都可以通过调整路径、修正代码细节来解决：

1. 先修正代码里的明显笔误 #

看你的测试代码，这里有个低级但致命的变量名错误：你创建的Mock对象是mocked_get_area_method，但在monkeypatch.setattr和断言步骤里却用了mocked_get_user_ip_method——这个变量根本没定义，这直接导致断言失败，甚至可能引发NameError！先把这个改过来：

class TestCommon:
    def test_calculations(self, monkeypatch):
        # 统一变量名，避免笔误
        mocked_get_area_method = Mock(return_value=500)
        monkeypatch.setattr(
            'project.common.services.utils.Calculations.get_area',
            mocked_get_area_method,  # 修正为正确的变量名
        )
        calculations = services.utils.Calculations()
        calculations.get_area()
        mocked_get_area_method.assert_called_once()  # 同步修正断言对象

2. 正确设置Monkeypatch的目标路径 #

你推测的没错，ModuleNotFoundError是因为monkeypatch需要Python可识别的完整导入路径。由于pytest从项目根目录运行，项目根目录已经在sys.path中，所以必须从顶层包project开始写路径，也就是project.common.services.utils.Calculations.get_area，而不是短路径services.utils.Calculations.get_area——后者Python找不到对应的模块。

3. 确保导入时机不影响修补效果 #

你提到的“修补未作用于实例”的问题，核心是要在monkeypatch之后再导入/实例化目标类。如果你的测试文件在顶部提前导入了services.utils.Calculations，比如：

# 测试文件顶部的导入
from project.common.services.utils import Calculations

这个Calculations类的引用会被Python缓存，之后即使你monkeypatch了模块里的类，测试中使用的还是缓存的旧引用。解决方法有两种：

• 方法一：在测试方法内部，monkeypatch之后再导入类：

  def test_calculations(self, monkeypatch):
      mocked_get_area_method = Mock(return_value=500)
      monkeypatch.setattr(
          'project.common.services.utils.Calculations.get_area',
          mocked_get_area_method,
      )
      # 在这里才导入类，确保使用被修补后的版本
      from project.common.services.utils import Calculations
      calculations = Calculations()
      calculations.get_area()
      mocked_get_area_method.assert_called_once()
  

• 方法二：如果必须在顶部导入，直接修补你导入的那个类的方法：

  # 测试文件顶部导入
  from project.common.services.utils import Calculations
  
  class TestCommon:
      def test_calculations(self, monkeypatch):
          mocked_get_area_method = Mock(return_value=500)
          # 直接修补已经导入的Calculations类的get_area方法
          monkeypatch.setattr(Calculations, 'get_area', mocked_get_area_method)
          calculations = Calculations()
          calculations.get_area()
          mocked_get_area_method.assert_called_once()
  

这种方式更直接，不需要写长长的字符串路径，也避免了路径写错的问题。

关键要点总结 #

• 修补类方法时，要么使用完整的模块路径字符串，要么直接修补已经导入的类对象；
• 确保Mock变量名一致，不要出现笔误；
• 控制好导入时机：如果在测试前导入了目标类，要么修补导入的类，要么在修补后重新导入。

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