如何在Django模型中设置主键从1001开始，自增且不影响原有数据

前提说明 #

Django默认主键id为AutoField类型，对应数据库自增字段。直接在模型里写auto_increment会报错——因为Django模型字段没有这个参数，必须通过迁移文件执行原生SQL修改自增起始值，且该操作不会影响已有数据。

步骤1：确认模型主键类型 #

如果未自定义主键，Django会自动生成id = models.AutoField(primary_key=True)，无需修改。若自定义主键，确保类型为AutoField或BigAutoField：

from django.db import models

class YourModel(models.Model):
    # 自定义主键示例（可选）
    id = models.AutoField(primary_key=True)
    name = models.CharField(max_length=100)
    # 其他字段...

步骤2：创建空迁移文件 #

在项目根目录执行命令（替换yourappname为你的应用名称）：

python manage.py makemigrations --empty yourappname

步骤3：编辑迁移文件，添加SQL操作 #

打开生成的迁移文件（位于yourappname/migrations/目录），根据数据库类型修改operations部分：

针对MySQL数据库

from django.db import migrations

class Migration(migrations.Migration):
    # 依赖项替换为当前最新迁移文件编号，比如'0001_initial'
    dependencies = [
        ('yourappname', '0001_initial'),
    ]

    operations = [
        migrations.RunSQL(
            # 替换表名为实际表名（默认是应用名_模型名小写）
            "ALTER TABLE yourappname_yourmodel AUTO_INCREMENT = 1001;",
            # 可选：回滚命令，执行migrate --reverse时使用
            reverse_sql="ALTER TABLE yourappname_yourmodel AUTO_INCREMENT = 1;"
        ),
    ]

针对PostgreSQL数据库

PostgreSQL通过序列管理自增，需修改对应序列起始值：

from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        ('yourappname', '0001_initial'),
    ]

    operations = [
        migrations.RunSQL(
            # 序列名默认是表名_id_seq，替换为实际序列名
            "ALTER SEQUENCE yourappname_yourmodel_id_seq RESTART WITH 1001;",
            reverse_sql="ALTER SEQUENCE yourappname_yourmodel_id_seq RESTART WITH 1;"
        ),
    ]

针对SQLite数据库（仅开发环境建议）

SQLite通过SQLITE_SEQUENCE表管理自增序列：

from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        ('yourappname', '0001_initial'),
    ]

    operations = [
        migrations.RunSQL(
            # seq设为1000，下一条数据id会是1001
            "UPDATE SQLITE_SEQUENCE SET seq = 1000 WHERE name = 'yourappname_yourmodel';",
            reverse_sql="UPDATE SQLITE_SEQUENCE SET seq = 0 WHERE name = 'yourappname_yourmodel';"
        ),
    ]

步骤4：执行迁移 #

在项目根目录执行命令应用迁移：

python manage.py migrate

关键注意事项 #

1. 避免主键冲突：执行迁移前先查询现有数据的最大主键值，确保起始值大于当前最大id：
   • MySQL：SELECT MAX(id) FROM yourappname_yourmodel;
   • PostgreSQL：SELECT last_value FROM yourappname_yourmodel_id_seq;
     若现有最大id ≥1001，需将起始值设为max_id + 1。
2. 不影响原有数据：此操作仅修改自增序列规则，已有数据的主键不会被修改。
3. 新增数据规则：后续新增数据的主键会从设置的起始值开始，每次自动递增1。

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