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的字段校验错误。
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

