已导入PostgreSQL的存量表如何生成对应Django模型？

1. 先做数据备份，绝对不能省 #

不管操作多熟练，先备份现有数据，避免意外：

• 用PgAdmin备份：选中目标数据库 → 右键→备份，保存为SQL文件
• 或命令行备份：pg_dump -U 用户名 数据库名 > backup.sql
  备份完成后，建议在测试库先尝试恢复一次，确认备份有效。

2. 用Django自带工具生成初始模型代码 #

Django的inspectdb命令可以直接读取现有数据库结构，自动生成模型代码，避免手动编写出错：

• 在项目根目录执行命令：

python manage.py inspectdb

• 命令会输出所有数据库表对应的模型代码，把country、region、town这几个表的代码复制到你的app的models.py文件里。

3. 修改模型适配现有表（关键步骤） #

默认生成的模型需要调整，重点处理复合主键和禁止Django管理表结构：

核心设置：managed = False #

在每个模型的Meta类里添加managed = False，这样Django不会对这些表执行创建、修改、删除操作，完全保留现有结构和数据：

class Country(models.Model):
    code = models.CharField(max_length=3)
    name = models.CharField(max_length=100)

    class Meta:
        managed = False
        db_table = 'country'  # 必须指定和现有数据库完全一致的表名

处理复合主键 #

如果表是复合主键（比如town表的country_code+region_code+town_code），要把每个主键字段都标记primary_key=True，并确保字段类型和数据库完全匹配：

class Town(models.Model):
    country_code = models.CharField(max_length=3, primary_key=True)
    region_code = models.CharField(max_length=5, primary_key=True)
    town_code = models.CharField(max_length=5, primary_key=True)
    name = models.CharField(max_length=100)

    class Meta:
        managed = False
        db_table = 'town'
        unique_together = (('country_code', 'region_code', 'town_code'),)  # 可选，和复合主键对应

修正外键关联 #

如果表之间有外键（比如region关联country），inspectdb生成的外键可能需要调整，确保关联字段正确，并且设置on_delete=models.DO_NOTHING避免误删关联数据：

class Region(models.Model):
    country_code = models.CharField(max_length=3, primary_key=True)
    region_code = models.CharField(max_length=5, primary_key=True)
    name = models.CharField(max_length=100)
    country = models.ForeignKey(Country, on_delete=models.DO_NOTHING, to_field='code', db_column='country_code')

    class Meta:
        managed = False
        db_table = 'region'

4. 验证模型可用性，不碰现有数据 #

调整完模型后，无需执行migrate（因为managed=False，migrate不会处理这些表），做以下验证：

• 检查模型语法：执行python manage.py check，确保没有语法错误
• 测试数据查询：进入Django shell

python manage.py shell

在shell里尝试查询数据，比如：

from yourapp.models import Country
print(Country.objects.first())  # 能正常输出数据说明模型没问题

如果查询报错，检查字段类型、主键设置、表名是否和数据库完全一致。

注意事项 #

• 绝对不要直接在生产库操作，先在本地测试库用备份数据调试模型，没问题再上线
• 对于复合主键的表，Django ORM的部分高级操作（比如update_or_create）可能需要手动处理，因为ORM默认依赖单一主键，这类操作可以直接用原生SQL或者手动判断逻辑
• 后续如果需要修改表结构，不要通过Django migrate，直接在PostgreSQL里修改，然后同步更新模型代码即可

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