DRF中TimeZoneField序列化报错及POST验证问题求助

问题背景 #

现有Django模型使用timezone_field.TimeZoneField存储时区：

from django.db import models
from timezone_field import TimeZoneField

class Client(models.Model):
    time_zone = TimeZoneField(choices_display='WITH_GMT_OFFSET')

对应的DRF APIView在GET请求时抛出序列化错误：TypeError: Object of type ZoneInfo is not JSON serializable，原序列化器代码：

class ClientListSerializer(serializers.ModelSerializer):
    class Meta:
        model = Client
        fields = ('id', 'time_zone')

将序列化器中time_zone改为serializers.CharField后，GET请求正常，但POST传入无效时区字符串（如{"time_zone": "invalid string"}）时，会抛出Django原生验证错误：django.core.exceptions.ValidationError: ["Invalid timezone 'invalid string'"]。

当前采用的非最优方案是用ChoiceField绑定pytz.all_timezones：

import pytz
from rest_framework import serializers

class ClientSerializer(serializers.ModelSerializer):
    time_zone = serializers.ChoiceField(choices=pytz.all_timezones)

    class Meta:
        model = Client
        fields = ('id', 'time_zone')

该方案的问题是需要硬编码所有时区选项，列表冗长且难以同步时区库的更新。

最优解决方案：自定义序列化字段 #

通过自定义DRF字段，统一处理ZoneInfo的序列化与时区字符串的验证逻辑，既解决序列化问题，又保持验证逻辑与模型层一致，同时避免硬编码选项。

1. 自定义时区序列化字段 #

from rest_framework import serializers
from timezone_field.validators import validate_timezone

class TimeZoneSerializerField(serializers.Field):
    def to_representation(self, value):
        # 将ZoneInfo对象转换为字符串格式输出
        return str(value)
    
    def to_internal_value(self, data):
        # 复用timezone_field的验证逻辑，确保输入时区有效
        try:
            validate_timezone(data)
            return data
        except serializers.ValidationError as e:
            raise e

2. 在序列化器中使用自定义字段 #

from rest_framework import serializers
from .models import Client
from .fields import TimeZoneSerializerField  # 导入自定义字段

class ClientSerializer(serializers.ModelSerializer):
    time_zone = TimeZoneSerializerField()

    class Meta:
        model = Client
        fields = ('id', 'time_zone')

方案优势 #

• 统一逻辑：一个字段同时处理序列化（ZoneInfo转字符串）和反序列化（时区字符串验证），代码更简洁
• 验证一致：复用timezone_field原生验证逻辑，避免模型层与序列化器层验证规则不一致
• 错误友好：抛出DRF标准的ValidationError，错误格式与其他字段统一，便于前端处理
• 可复用性：自定义字段可直接用于其他需要处理时区的序列化器中
• 无需硬编码：不需要维护冗长的时区选项列表，自动适配时区库的更新

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