Django DurationField零时长00:00:00被识别为NULL问题处理

是不是预期设计？ #

这不是Django或MySQL的预期设计：

• Django的DurationField原生支持零时长timedelta(seconds=0)，会将其作为合法的非NULL值处理
• MySQL 8.x的TIME类型（对应Django DurationField的底层存储类型）也将'00:00:00'作为合法有效值，和NULL值完全区分

出现零时长被识别为NULL的问题，通常是上层存储逻辑（如表单处理、模型clean方法、第三方插件）将零值误判为空值，主动存为了NULL导致的。

排查与修复方案 #

1. 先确认数据库存储的实际值 #

先直接连接MySQL执行查询，确认你以为存了零时长的行，实际period字段是不是真的被存成了NULL：

SELECT id, period FROM subobject WHERE period IS NULL;

如果查询结果里包含你设置了零时长的行，说明是存储环节把零值转成了NULL，按下面的方法修复存储逻辑即可。

2. 修复存储逻辑 #

修正模型层逻辑

显式在模型的clean方法中保留零时长，避免被默认的空值判断过滤：

from datetime import timedelta
from django.db import models

class Object(models.Model):
   period = models.DurationField('Period', null=False, blank=False, default=timedelta(days=1))

class Subobject(models.Model):
   # 注意你原代码里的CASCASE是笔误，正确拼写为CASCADE
   object = models.ForeignKey(Object, null=False, blank=False, on_delete=models.CASCADE)
   period = models.DurationField('Period', null=True, blank=True)

   def clean(self):
       # 显式保留零时长，不做转空处理
       super().clean()

修正后台Admin的保存逻辑

如果是后台Admin提交时出现问题，重写Admin的save_model方法强制保留零时长：

from django.contrib import admin
from datetime import timedelta
from .models import Subobject

class SubobjectAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        period = form.cleaned_data.get('period')
        if period == timedelta(0):
            obj.period = period
        super().save_model(request, obj, form, change)

admin.site.register(Subobject, SubobjectAdmin)

3. 优化查询逻辑 #

可以用Django原生的Coalesce函数替代你写的Case When逻辑，写法更简洁，同时避免逻辑漏洞：

from django.db.models import Coalesce
from datetime import timedelta

sub_objs = Subobject.objects.select_related(
    'object'
).annotate(
    actual_period=Coalesce('period', 'object__period', output_field=models.DurationField())
).filter(
    actual_period__gte=timedelta(seconds=3600)
)

Coalesce的作用就是返回第一个非NULL的参数值，和你原来的业务逻辑完全一致。

额外建议 #

如果你用的是Django 3.2.7版本，该版本存在少量DurationField相关的小bug，你可以升级到Django 3.2系列的最新维护版本（如3.2.20），小版本升级完全兼容，不会引入破坏性变更。

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