Django自定义字段设默认值后重复生成迁移问题求助

问题根源 #

Django迁移系统会对字段默认值做深比较，如果默认值是可变对象（比如直接传入{}或自定义字典实例），每次Django加载模块时都会生成新的对象引用，导致迁移系统误判为默认值发生变更。

具体解决方法 #

1. 使用可调用对象返回默认值 #

不要直接传可变字典作为default参数，改用函数或lambda表达式返回默认值：

from django.db import models

def get_default_struct():
    return {"sub_field1": "", "sub_field2": 0}  # 你的默认字典结构

class JSONStructField(models.JSONField):
    def __init__(self, *args, **kwargs):
        # 用可调用对象替代直接传字典
        kwargs.setdefault("default", get_default_struct)
        super().__init__(*args, **kwargs)

Django迁移系统只会检查default是否指向同一个可调用对象，不会深比较返回的字典内容，以此避免误判。

2. 手动修正已生成的迁移文件 #

如果已经生成了重复的迁移，可以打开最新的迁移文件，将该字段的default值改为字符串形式的JSON（例如"'{\"sub_field1\": \"\", \"sub_field2\": 0}'"），确保和自定义字段的默认值定义一致，之后运行python manage.py migrate同步即可。

3. 覆盖字段的deconstruct方法（进阶） #

自定义字段时覆盖deconstruct方法，明确控制默认值的序列化逻辑：

class JSONStructField(models.JSONField):
    def __init__(self, *args, **kwargs):
        self._raw_default = kwargs.pop("default", {})
        # 确保默认值是可调用对象
        self.default = self._raw_default if callable(self._raw_default) else lambda: self._raw_default
        super().__init__(*args, **kwargs)

    def deconstruct(self):
        name, path, args, kwargs = super().deconstruct()
        # 序列化默认值为固定形式
        if not callable(self._raw_default):
            kwargs["default"] = self._raw_default
        else:
            kwargs["default"] = self._raw_default
        return name, path, args, kwargs

这个方法能精准控制迁移时默认值的解析逻辑，确保每次生成的迁移内容一致。

验证方式 #

修改后运行python manage.py makemigrations，如果不再生成新的迁移文件，说明问题解决。同时测试模型实例的该字段默认值是否正常生效，确保功能不受影响。

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