本文详解在 Python 单元测试中为何直接 @patch 导入的类常失效，并给出正确打补丁位置、作用域及导入方式的核心原则，辅以可运行示例与关键注意事项。
本文详解在 python 单元测试中为何直接 `@patch` 导入的类常失效，并给出正确打补丁位置、作用域及导入方式的核心原则，辅以可运行示例与关键注意事项。
在 Python 的 unittest.mock 中，@patch 的核心原则是：必须 patch 被测试代码「实际引用该对象的位置」，而非其定义位置。这是初学者最容易踩坑的地方——你不是要 mock 类“在哪里写的”，而是要 mock 它“在哪里被用的”。
回顾你的项目结构：
-
src/client.py定义了Client1类； -
src/get_foos.py导入并实例化了Client1（client = Client1()），并在get_foo()中调用其实例方法； - 测试文件
src/test/test_get_foos.py导入的是get_foo函数本身（即from src.get_foos import get_foo）。
⚠️ 问题根源就在这里：当你执行 from src.get_foos import get_foo 时，Python 已将 get_foo 这个函数对象绑定到当前命名空间；而该函数内部使用的 client 实例，是在 src/get_foos.py 模块加载时创建的——它依赖的是该模块内 Client1 的本地引用。因此，若你在测试中 @patch('src.get_store.Client1')（注意路径还写错了，应为 src.client.Client1），实际 patch 的是另一个模块里的类，对 src/get_foos.py 中已存在的 client 实例毫无影响。
✅ 正确做法是：patch src.get_foos 模块中所使用的 Client1 —— 即 patch src.get_foos.Client1（因为 get_foos.py 中写了 from .src import Client1，所以 Client1 已作为名称存在于该模块全局命名空间中）。
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
立即学习“Python免费学习笔记（深入）”；
以下是修复后的完整可运行测试示例：
# src/test/test_get_foos.py
import unittest
from unittest.mock import patch
# ✅ 正确：patch 被测模块（src.get_foos）中实际使用的类名
from src import get_foos # ← 导入模块，而非函数
class TestGetFoos(unittest.TestCase):
@patch('src.get_foos.Client1') # ← 关键：路径为 'src.get_foos.Client1'
def test_get_foo(self, mock_client_class):
# 配置 mock：让 Client1() 实例的 get_foo 方法返回预期值
mock_instance = mock_client_class.return_value
mock_instance.get_foo.return_value = 'myfoo'
result = get_foos.get_foo()
self.assertEqual(result, 'myfoo')
@patch('src.get_foos.Client1')
def test_get_bar(self, mock_client_class):
mock_instance = mock_client_class.return_value
mock_instance.get_foo.return_value = 'mybar'
result = get_foos.get_bar()
self.assertEqual(result, 'mybar')? 关键说明：
-
@patch('src.get_foos.Client1')中的字符串路径必须与get_foos.py模块内「名称绑定的位置」完全一致； - 因为
get_foos.py中是from .src import Client1，所以Client1是直接作为名称存在于src.get_foos命名空间中的； -
mock_client_class.return_value表示对Client1()构造调用的返回值（即client实例），后续所有对该实例的方法调用（如.get_foo()）都需在其上配置； - 永远不要 patch 定义处（如
src.client.Client1），除非被测代码是import src.client; c = src.client.Client1()这种显式模块限定调用。
? 进阶建议：
若 Client1 实例在 get_foos.py 中是模块级全局变量（如你当前的 client = Client1()），且你希望避免 patch 类构造器，也可考虑重构为依赖注入（例如 get_foo(client=None)），但这会增加调用方负担。对于已有大量方法且不希望修改业务逻辑的场景，正确使用 @patch 作用于使用点，是最轻量、最符合现有架构的解决方案。
总结一句话：Patch 的目标永远是「被测代码从哪里拿到这个对象」，而不是「这个对象从哪里来」。 掌握这一点，90% 的 mock 失效问题迎刃而解。
