Python unittest Mock含点号关键字参数的解包问题及替代方案

核心结论 #

两种写法语法层面完全不等价，Python的语法规则限制了第二种写法的可行性，而字典解包配合Mock的内部逻辑实现了第一种写法的功能。

1. 为什么第二种写法触发语法错误？ #

Python对关键字参数的名称有严格要求：必须是有效的标识符（只能包含字母、数字、下划线，且不能以数字开头）。method.return_value中的.属于表达式运算符，不符合标识符的定义，因此直接作为关键字参数传递时，Python解释器会抛出SyntaxError: keyword can't be an expression。

2. 字典解包时发生了什么？ #

当使用**解包字典时，Python会将字典的键以字符串形式传递给函数的**kwargs参数，而不会对这些键做语法层面的标识符校验。也就是说，{'method.return_value': 3}解包后，函数接收到的是一个键为字符串'method.return_value'、值为3的键值对，绕过了关键字参数的语法限制。

3. Mock是如何处理第一种写法的？ #

Mock的初始化方法（以及configure_mock方法）会专门处理传入的kwargs：

• 遍历所有键值对，若键中包含.，则将其拆解为属性访问链。
• 比如'method.return_value': 3会被解析为：先获取（或自动创建）mock对象的method属性（一个子Mock实例），再将该子Mock的return_value属性设置为3。
• 同理，'other.side_effect': KeyError会设置mock的other子Mock的side_effect属性。

4. 无需使用**的Mock初始化方式 #

有两种常用替代方案：

• 使用双下划线语法糖：Mock类支持用双下划线__替代属性链中的.，直接作为关键字参数传递，无需字典解包：

  mock = Mock(some_attribute='eggs', method__return_value=3, other__side_effect=KeyError)
  

  内部会自动将method__return_value转换为method.return_value进行处理。
• 手动设置子属性：先创建Mock实例，再逐个设置子Mock的属性，逻辑更直观：

  mock = Mock(some_attribute='eggs')
  mock.method.return_value = 3
  mock.other.side_effect = KeyError
  

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