解决Django Rest Framework序列化NaN值时的JSON兼容错误

我之前也碰到过一模一样的问题！JSON标准里压根不支持NaN、Infinity这类特殊浮点值，Django REST Framework默认的序列化器一碰到它们就直接报错。别担心，序列化过程完全不是黑盒，咱们有几个简单的办法能搞定：

方法1：自定义字段/全局处理NaN值（推荐） #

最稳妥的方式是在序列化层把NaN转换成JSON兼容的null（或者你需要的其他合法值），这样不管什么客户端都能正常解析。

方案A：针对单个字段自定义处理 #

如果知道具体哪个字段会出现NaN，可以专门为这个字段写一个自定义序列化字段：

from rest_framework import serializers
from api.models import Order

# 自定义处理NaN的浮点字段
class NaNSafeFloatField(serializers.FloatField):
    def to_representation(self, value):
        # 判断是否是NaN或正负无穷，是的话返回null
        if isinstance(value, float):
            if value != value or value in (float('inf'), float('-inf')):
                return None
        # 其他情况按默认逻辑处理
        return super().to_representation(value)

class OrderSerializer(serializers.ModelSerializer):
    # 假设你的NaN字段是`amount`，替换成你实际的字段名
    amount = NaNSafeFloatField()

    class Meta:
        model = Order
        fields = ('id', 'status', 'description', 'amount')

方案B：全局处理所有字段 #

如果不确定哪个字段有NaN，或者想批量处理所有可能的浮点字段，可以重写序列化器的to_representation方法：

from rest_framework import serializers
from api.models import Order

class OrderSerializer(serializers.ModelSerializer):
    class Meta:
        model = Order
        fields = ('id', 'status', 'description')

    def to_representation(self, instance):
        # 先拿到默认序列化后的字典数据
        data = super().to_representation(instance)
        
        # 遍历所有字段，把NaN/正负无穷转成null
        for key, value in data.items():
            if isinstance(value, float):
                if value != value or value in (float('inf'), float('-inf')):
                    data[key] = None
        
        return data

方法2：允许序列化NaN值（谨慎使用） #

如果你的客户端（比如某些JavaScript环境）能够兼容非标准JSON里的NaN，可以修改DRF的JSON渲染器，让它允许输出这些特殊值：

首先在你的app里创建一个renderers.py文件，写自定义渲染器：

from rest_framework.renderers import JSONRenderer
import json

class NanAllowedJSONRenderer(JSONRenderer):
    def render(self, data, accepted_media_type=None, renderer_context=None):
        return json.dumps(
            data,
            cls=self.encoder_class,
            allow_nan=True,  # 关键：允许NaN和无穷值
            indent=self.get_indent(accepted_media_type, renderer_context)
        ).encode(self.charset)

然后在项目的settings.py里配置DRF使用这个渲染器：

REST_FRAMEWORK = {
    'DEFAULT_RENDERER_CLASSES': [
        'your_app.renderers.NanAllowedJSONRenderer',  # 替换成你的app路径
        'rest_framework.renderers.BrowsableAPIRenderer',  # 保留浏览器可查看的API界面
    ],
}

⚠️ 注意：这个方法输出的内容严格来说不符合JSON标准，如果客户端是严格遵循规范的（比如某些后端服务、严谨的前端框架），可能会解析失败，所以优先推荐方法1。

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