Django ORM：如何避免插入语句包含auto_increment_id空值字段？

针对你的场景，核心问题是Django在插入新记录时会主动将auto_increment_id设为NULL，覆盖了数据库层面的自增默认值。以下是几种可行的解决方法：

方法1：使用Django 3.2+的db_default参数（推荐） #

db_default是Django 3.2新增的参数，用于指定数据库层面的默认值表达式，Django会在插入时跳过该字段，直接让数据库处理默认值生成。

PostgreSQL示例（假设已创建序列） #

如果你的数据库是PostgreSQL，且已经为auto_increment_id创建了序列：

CREATE SEQUENCE some_class_auto_increment_id_seq OWNED BY some_class.auto_increment_id;
ALTER TABLE some_class ALTER COLUMN auto_increment_id SET DEFAULT nextval('some_class_auto_increment_id_seq');

修改模型字段定义：

from django.db.models import Func
import uuid
from django.db import models

class NextVal(Func):
    function = 'nextval'
    template = "%(function)s('%(sequence)s')"

class SomeClass(CoreModel):
    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
    auto_increment_id = models.BigIntegerField(
        null=True, 
        blank=True, 
        db_index=True,
        db_default=NextVal('some_class_auto_increment_id_seq')
    )

MySQL示例（依赖触发器实现自增） #

MySQL不支持非主键字段设置AUTO_INCREMENT，你可能需要通过触发器实现自增逻辑。此时只需在模型中设置db_default=None，确保Django插入时不传递该字段：

class SomeClass(CoreModel):
    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
    auto_increment_id = models.BigIntegerField(
        null=True, 
        blank=True, 
        db_index=True,
        db_default=None
    )

方法2：重写模型save方法（兼容旧版Django） #

通过重写save方法，在插入新对象时临时移除auto_increment_id字段，避免Django将其设为NULL插入，保存后再从数据库刷新获取生成的值：

import uuid
from django.db import models

class SomeClass(CoreModel):
    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
    auto_increment_id = models.BigIntegerField(null=True, blank=True, db_index=True)

    def save(self, *args, **kwargs):
        is_new = self._state.adding
        if is_new:
            # 临时移除字段，阻止Django插入NULL
            original_fields = list(self._meta.fields)
            self._meta.fields = [f for f in original_fields if f.name != 'auto_increment_id']
        
        super().save(*args, **kwargs)
        
        if is_new:
            # 恢复原字段列表并刷新获取数据库生成的值
            self._meta.fields = original_fields
            self.refresh_from_db(fields=['auto_increment_id'])

方法3：原生SQL插入（兜底方案） #

如果上述方法都不适用，可以直接使用原生SQL执行插入，完全控制SQL语句：

from django.db import connection
import uuid

def create_some_class():
    new_id = uuid.uuid4()
    with connection.cursor() as cursor:
        # 根据数据库类型调整SQL，PostgreSQL用RETURNING，MySQL用168168
        cursor.execute(
            "INSERT INTO some_class (id) VALUES (%s) RETURNING auto_increment_id",
            (new_id,)
        )
        auto_inc_id = cursor.fetchone()[0]
    return SomeClass.objects.get(id=new_id)

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