MicroPython-lib中requests模块的headers参数处理问题分析

问题背景

在MicroPython的requests模块使用过程中，开发者发现了一个与HTTP请求头(headers)处理相关的问题。当用户向requests.get()方法传递headers参数时，该模块会意外地修改调用者提供的headers字典对象，这种行为与标准Python的requests库表现不一致。

问题现象

通过一个简单的测试用例可以重现这个问题：

import requests
headers = {}  # 创建一个空字典作为请求头

response = requests.get(
    url="http://www.google.com",
    headers=headers,  # 传入空字典
    data="string",
)

print(headers)  # 发现headers字典已被修改
assert headers == {}, "requests返回了被修改的headers给调用者"

在标准Python环境下，这个测试用例会正常通过，因为标准requests库不会修改调用者的headers字典。但在MicroPython环境下，测试会失败，因为headers字典被意外修改了。

技术分析

这个问题的根源在于MicroPython的requests模块实现中，没有对传入的headers参数进行保护性拷贝。当模块内部需要添加默认头信息(如User-Agent)时，它直接修改了传入的字典对象，而不是先创建一个副本。

正确的做法应该是：

1. 接收headers参数
2. 创建该参数的深拷贝或浅拷贝(对于headers来说，浅拷贝通常足够)
3. 在拷贝上进行修改操作
4. 使用修改后的拷贝进行HTTP请求

解决方案

修复方案非常简单，只需要在修改headers前创建一个副本即可。具体实现是在处理headers参数时添加以下代码：

if headers is None:
    headers = {}
else:
    headers = headers.copy()  # 创建调用者headers的副本

这样修改后，模块内部对headers的所有操作都将在副本上进行，不会影响调用者传入的原始字典。

影响范围

这个问题会影响所有使用MicroPython requests模块并直接传递字典对象作为headers参数的场景。特别是当开发者重复使用同一个headers字典对象进行多次请求时，可能会遇到不可预期的行为。

最佳实践

为了避免类似问题，开发者可以采取以下措施：

1. 总是在传递headers参数前显式创建字典副本
2. 或者使用不可变对象(如frozenset)作为headers的基础
3. 考虑使用请求库提供的工具方法创建标准headers

总结

MicroPython-lib的requests模块的这个行为差异已经被修复。这个案例提醒我们，在编写库代码时，应该特别注意不要意外修改调用者传入的可变对象，这是API设计中的一个重要原则。对于接收字典、列表等可变对象作为参数的函数，应该考虑是否需要保护性拷贝，以避免副作用。