You need to enable JavaScript to run this app. Django 2.2.5 枚举模型字段默认值设置方法与迁移报错处理
优惠活动
大模型
产品
解决方案
定价
更多

Django 2.2.5 枚举模型字段默认值设置方法与迁移报错处理

报错本质原因

你遇到的问题核心是自定义原生枚举类与Django迁移序列化逻辑的适配错位,和数据库本身的校验规则冲突:

  • 你在模型中设置的default=NetworkProtocolList.ETH,本质是NetworkProtocolList的枚举类实例对象,不是数据库能识别的原生字符串值
  • Django的迁移序列化流程,只会对自己内置的枚举类型(如models.TextChoices、models.IntegerChoices)做专门的逻辑处理:自动提取枚举成员对应的实际存储值(即.value属性)作为默认值写入迁移文件
  • 你自己基于Python原生enum.Enum编写的自定义枚举类,没有实现Django要求的序列化接口,Django只能按通用类实例的规则序列化:最终生成的迁移代码里,默认值被写成了my_app.utils.NetworkProtocolList('Ethernet')这种构造枚举实例的表达式
  • 当迁移执行时,这个表达式运行得到的依然是枚举实例对象,而非字符串值,MySQL拿到无法正常解析为合法字段值的对象做默认值设置时,就会触发1067 Invalid default value的报错
为什么之前其他字段用枚举当默认值可以正常运行

大概率你之前使用的是Django内置的枚举类(Django 2.0之后逐步引入,2.2.5版本已经完整支持)。这类内置枚举是Django官方适配过的类型,序列化时会自动提取实际存储值,不会把枚举实例直接传给数据库层,所以迁移流程可以正常走完。

另外要注意你当前自定义枚举的实现还有一个隐藏的逻辑bug:
你编写的choices()方法返回的元组是(key.name, key.value),也就是数据库实际存储值是枚举成员的name(如'ETH'、'MPLS'),但你设置的默认值是枚举的value(如'Ethernet'、'MPLS'),二者是不匹配的。哪怕迁移流程能正常通过,后续新建记录时也会触发Django的字段校验错误。

这不属于框架本质Bug

Django的序列化机制从设计上就只对接官方内置的枚举实现,自定义原生枚举和框架的适配缺失属于生态层的兼容问题,不是框架功能缺陷。

Django中枚举选择字段的正确实现方式

方案1:最小改动,直接指定枚举的实际存储值当默认值

不需要修改枚举类的结构,只需要把模型字段的默认值从枚举成员改为对应的.value属性:

# 修改后的models.py
protocol = models.CharField(
    choices=NetworkProtocolList.choices(),
    max_length=20,
    default=NetworkProtocolList.ETH.value
)

这种写法的好处是完全兼容现有自定义枚举的逻辑,传给字段的默认值本身就是原生字符串,Django序列化时会直接生成字面量字符串,不需要手动修改迁移文件,MySQL也能正常识别默认值。

额外建议:调整choices()的返回逻辑,让存储值和默认值匹配:

# 修改后的utils.py,把存储值和默认值统一
@classmethod
def choices(cls):
    return [(key.value, key.value) for key in cls]

方案2:换用Django内置的枚举类,实现全流程自动适配

将自定义枚举类改为继承Django内置的models.TextChoices,完全贴合Django的迁移校验逻辑,不需要额外处理序列化问题:

# 修改后的utils.py
from django.db import models

class NetworkProtocolList(models.TextChoices):
    ETH = 'Ethernet', 'Ethernet'
    MPLS = 'MPLS', 'MPLS'

模型字段的写法完全不需要调整,直接使用枚举成员当默认值即可:

# 模型字段写法保持不变
protocol = models.CharField(
    choices=NetworkProtocolList.choices,
    max_length=20,
    default=NetworkProtocolList.ETH
)

这种写法下,Django会自动识别内置枚举类型,序列化迁移时自动提取对应的字符串值,全程不需要手动修改迁移文件,从根源上避免枚举实例被当作数据库默认值的问题。

为什么手动修改迁移文件的默认值为字面量就可以正常执行

数据库层本身只识别原生类型(字符串、数字等)的默认值,只要迁移中写入的默认值是纯字符串'Ethernet',MySQL就能正常识别校验,本质上是绕过了枚举实例被误传为数据库默认值的问题。


内容的提问来源于stack exchange,提问作者donmelchior

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 09:24:06