Requests库中Decimal类型的JSON序列化问题解析

问题背景

在使用Python的Requests库发送HTTP请求时，开发者可能会遇到一个常见问题：当请求体包含Decimal类型数据时，如果没有安装simplejson库，就会抛出"TypeError: Object of type Decimal is not JSON serializable"异常。这个问题源于Python标准库json模块对Decimal类型的处理方式。

技术原理

Python标准库中的json模块默认不支持Decimal类型的序列化，因为Decimal不是JSON规范中的原生数据类型。当Requests库使用标准json模块序列化数据时，遇到Decimal对象就会抛出异常。

而simplejson作为json模块的替代品，提供了更全面的数据类型支持，包括Decimal类型。当simplejson安装后，Requests库会自动优先使用它，从而能够正确处理Decimal类型的数据。

解决方案比较

方案一：安装simplejson

这是最简单的解决方案，只需执行：

pip install simplejson

安装后，Requests会自动使用simplejson进行序列化，Decimal类型会被正确处理。

方案二：自定义JSON编码器

如果不希望依赖simplejson，可以自定义JSON编码器：

import json
from decimal import Decimal
import requests

class DecimalEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, Decimal):
            return float(obj)
        return super().default(obj)

data = {'key': Decimal('0.0')}
json_data = json.dumps(data, cls=DecimalEncoder)
response = requests.post(url, data=json_data, headers={'Content-Type': 'application/json'})

方案三：手动转换Decimal为float

在构建请求数据时，手动将Decimal转换为float：

data = {'key': float(Decimal('0.0'))}
response = requests.post(url, json=data)

性能考量

simplejson在大多数情况下性能优于标准json模块，特别是在处理复杂数据结构时。然而，对于简单数据，差异可能不明显。如果项目已经大量使用Decimal类型，引入simplejson是更合理的选择。

最佳实践建议

1. 如果项目频繁使用Decimal类型，建议直接安装simplejson
2. 对于临时性需求，可以使用自定义编码器或手动转换
3. 在性能敏感场景下，建议进行基准测试，选择最适合的序列化方案
4. 确保团队所有成员使用相同的序列化方案，避免环境差异导致的问题

总结

Requests库的JSON序列化行为会根据可用依赖自动调整，理解这一机制有助于开发者更好地处理特殊数据类型。Decimal类型的问题只是JSON序列化中的一个典型案例，类似的问题可能出现在其他非标准JSON数据类型上。掌握这些解决方案，能够使开发者在处理复杂数据时更加得心应手。