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

问题背景

在使用Python的Requests库发送HTTP请求时，开发人员经常需要将包含Decimal类型数据的字典转换为JSON格式进行传输。然而，当系统中没有安装simplejson库时，Requests使用Python标准库的json模块进行序列化，这会导致Decimal类型无法被正确序列化的问题。

问题现象

当尝试发送包含Decimal类型数据的请求时，如果没有安装simplejson库，会抛出TypeError: Object of type Decimal is not JSON serializable异常。而安装simplejson后，相同的代码却能正常工作。

技术原理

Python标准库的json模块默认不支持Decimal类型的序列化，因为它不是JSON规范中的原生数据类型。而simplejson作为第三方库，提供了对Decimal类型的支持，能够自动将其转换为JSON兼容的浮点数或字符串格式。

Requests库在内部会优先尝试使用simplejson（如果已安装），回退到标准库的json模块。这种设计导致了不同环境下行为不一致的问题。

解决方案

方案一：安装simplejson

最简单的解决方案是安装simplejson库：

pip install simplejson

方案二：自定义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或str：

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

最佳实践

1. 如果项目需要处理大量Decimal类型数据，建议安装simplejson以获得更好的兼容性和性能
2. 在共享代码时，应该明确声明对simplejson的依赖，或者在代码中处理类型转换
3. 对于金融等对精度要求高的应用，建议将Decimal转换为字符串传输，避免浮点数精度损失

总结

Requests库的JSON序列化行为差异源于其对不同JSON处理库的适配策略。理解这一机制有助于开发人员更好地处理特殊数据类型，构建更健壮的HTTP请求逻辑。根据项目需求选择合适的解决方案，可以避免这类兼容性问题。