Django DRF接口提交时date字段接收datetime类型报错如何解决

报错核心是DRF默认对模型映射的DateField字段做严格类型校验，你提交的POST参数里对应日期字段的值是带时间的datetime格式（比如2024-05-20T14:30:00+08:00），DRF为了避免丢失时区信息，不会主动把datetime强制转为date类型，因此抛出断言错误。

方案1：序列化器显式指定日期字段的输入格式（最常用） #

在序列化器中手动覆盖所有日期字段，指定input_formats参数，使其支持带时间的输入格式，自动提取日期部分：

from rest_framework import serializers
from .models import Yogatour

class YogatourSerializer(serializers.ModelSerializer):
    # 手动指定所有日期字段的输入格式，支持ISO格式的datetime自动转date
    start_date = serializers.DateField(input_formats=['%Y-%m-%d', '%Y-%m-%dT%H:%M:%S.%fZ', '%Y-%m-%dT%H:%M:%S%z'])
    end_date = serializers.DateField(input_formats=['%Y-%m-%d', '%Y-%m-%dT%H:%M:%S.%fZ', '%Y-%m-%dT%H:%M:%S%z'])
    reg_start_date = serializers.DateField(input_formats=['%Y-%m-%d', '%Y-%m-%dT%H:%M:%S.%fZ', '%Y-%m-%dT%H:%M:%S%z'])
    reg_end_date = serializers.DateField(input_formats=['%Y-%m-%d', '%Y-%m-%dT%H:%M:%S.%fZ', '%Y-%m-%dT%H:%M:%S%z'])

    class Meta:
        fields = ('id', 'title', 'description', 'start_date', 'end_date', 'reg_start_date','reg_end_date','author','status')
        model = Yogatour

也可以全局配置DRF的日期输入格式，避免每个序列化器重复配置，在settings.py中添加：

REST_FRAMEWORK = {
    'DATE_INPUT_FORMATS': ['%Y-%m-%d', '%Y-%m-%dT%H:%M:%S.%fZ', '%Y-%m-%dT%H:%M:%S%z'],
}

如果需要按时区转换日期，可在输入转换逻辑中先把datetime转换为目标时区后再取date部分即可。

方案2：自定义日期字段处理datetime转date逻辑 #

如果需要更灵活的转换逻辑，可以自定义字段类：

class DateTimeToDateField(serializers.DateField):
    def to_internal_value(self, value):
        # 如果输入是datetime对象，直接取date部分
        if hasattr(value, 'date'):
            value = value.date()
        return super().to_internal_value(value)

# 序列化器中使用自定义字段
class YogatourSerializer(serializers.ModelSerializer):
    start_date = DateTimeToDateField(blank=True, null=True)
    end_date = DateTimeToDateField(blank=True, null=True)
    reg_start_date = DateTimeToDateField(blank=True, null=True)
    reg_end_date = DateTimeToDateField(blank=True, null=True)

    class Meta:
        fields = ('id', 'title', 'description', 'start_date', 'end_date', 'reg_start_date','reg_end_date','author','status')
        model = Yogatour

方案3：前端侧处理提交格式 #

如果前端可调整，提交时把所有日期字段的datetime值转换为YYYY-MM-DD格式的纯日期字符串即可，无需修改后端代码。

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