Django 2.2及以上版本项目启动时运行的一次性DB交互代码应放在何处

可行的合规实现方案 #

方案1：使用post_migrate信号（适合每次启动/迁移后都需要执行的校验逻辑） #

这是Django官方推荐的用于初始化数据、执行DB相关启动校验的方式，信号会在所有应用的迁移操作完成后触发，此时DB连接、表结构都已完全就绪，不会出现启动阶段的DB访问错误。
实现步骤：

• 在对应应用下新建signals.py文件，写入逻辑：

from django.db.models.signals import post_migrate
from django.dispatch import receiver
from .models import YourModel # 替换为你要操作的模型

@receiver(post_migrate)
def check_and_create_target_content(sender, **kwargs):
    # 只在当前应用的迁移完成后执行，避免多应用触发多次
    if sender.name == 'your_app_name': # 替换为你的应用名
        # 你的校验创建逻辑
        YourModel.objects.get_or_create(
            # 你的查询条件
            defaults={
                # 不存在时的默认字段值
            }
        )

• 在应用的apps.py的ready()方法中注册信号，注意这里只做信号注册，不执行DB操作，符合Django规范：

from django.apps import AppConfig

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'your_app_name'

    def ready(self):
        import your_app_name.signals # 替换为你的信号文件导入路径

方案2：自定义迁移操作（适合只需要执行一次的固定数据初始化场景） #

如果你的校验逻辑只是为了初始化项目必须的基础数据，不需要每次启动都运行，直接写在迁移文件中最合理：
执行命令生成空迁移文件：
python manage.py makemigrations your_app_name --empty
打开生成的迁移文件，修改内容如下：

from django.db import migrations

def init_target_content(apps, schema_editor):
    YourModel = apps.get_model('your_app_name', 'YourModel')
    YourModel.objects.get_or_create(
        # 你的查询条件
        defaults={
            # 默认值
        }
    )

class Migration(migrations.Migration):
    dependencies = [
        # 这里是自动生成的依赖，不要修改
    ]

    operations = [
        migrations.RunPython(init_target_content),
    ]

后续执行python manage.py migrate时会自动运行该逻辑，只会执行一次，符合Django的生命周期规范。

方案3：自定义管理命令（适合按需手动执行的场景） #

如果你的逻辑不需要自动触发，只需要在需要的时候运行，可以写成自定义管理命令：

• 在应用下新建management/commands目录，新增init_content.py文件：

from django.core.management.base import BaseCommand
from your_app_name.models import YourModel

class Command(BaseCommand):
    help = '校验并创建指定内容'

    def handle(self, *args, **options):
        obj, created = YourModel.objects.get_or_create(
            # 查询条件
            defaults={}
        )
        if created:
            self.stdout.write(self.style.SUCCESS('目标内容创建成功'))
        else:
            self.stdout.write(self.style.SUCCESS('目标内容已存在'))

需要执行时直接运行命令即可：
python manage.py init_content

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