单元测试时，如何指定mock.patch路径模拟Python列表的append方法？

你遇到的TypeError: Need a valid target to patch错误，核心原因是mock.patch需要传入完整的可导入对象路径，而append不是一个顶层可导入对象——它是Python内置list类的方法，或是你目标列表实例的方法。下面给两种针对性的解决方案：

方案1：直接Mock目标列表的append方法（推荐） #

如果你的foo是模块级别的列表（比如在被测试文件里定义的全局列表），直接Mock这个列表实例的append方法最直接，不会影响其他列表的行为。

假设被测试代码在my_module.py中：

# my_module.py
foo = []

def check_and_append(bar):
    if bar == 'a':
        foo.append(bar)

对应的测试代码：

from unittest import mock
import my_module

def test_append_when_bar_is_a():
    # 用mock.patch.object直接Mock foo的append方法
    with mock.patch.object(my_module.foo, 'append') as mock_append:
        # 执行被测试函数
        my_module.check_and_append('a')
        # 断言append被正确调用
        mock_append.assert_called_once_with('a')

def test_no_append_when_bar_not_a():
    with mock.patch.object(my_module.foo, 'append') as mock_append:
        my_module.check_and_append('b')
        # 断言append未被调用
        mock_append.assert_not_called()

方案2：Mock内置list类（适用于函数内创建的列表） #

如果foo是在被测试函数内部创建的局部列表，你需要Mock全局的list类，然后追踪它的append调用：

被测试代码：

# my_module.py
def check_and_append(bar):
    foo = []
    if bar == 'a':
        foo.append(bar)
    return foo

测试代码：

from unittest import mock
import my_module

def test_append_when_bar_is_a():
    with mock.patch('builtins.list') as mock_list:
        # 获取Mock列表实例的append方法
        mock_append = mock_list.return_value.append
        
        my_module.check_and_append('a')
        # 验证append被调用
        mock_append.assert_called_once_with('a')

def test_no_append_when_bar_not_a():
    with mock.patch('builtins.list') as mock_list:
        mock_append = mock_list.return_value.append
        
        my_module.check_and_append('b')
        mock_append.assert_not_called()

关键注意点 #

• Mock的核心原则：Patch对象被访问的位置，而不是它定义的位置。比如如果你的foo是在被测试模块里，就patchmy_module.foo.append；如果是函数内创建的列表，就patchbuiltins.list。
• 避免直接patchappend这种无路径的名称，必须给mock提供一个可定位的对象路径。

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