如何在Django项目中添加单元测试检查待处理迁移？

要让本地开发者运行测试时自动检查是否有未生成的数据库迁移（对应makemigrations --check的功能），最直接可靠的方式是在单元测试中调用Django内置的命令或迁移检查逻辑，以下是两种常用方案：

方案一：直接调用makemigrations --check命令 #

这种方式完全复用Django官方命令的逻辑，和开发者日常操作的行为一致，实现简单易懂：

1. 在项目的测试目录（如tests/）下新建test_migrations.py文件
2. 编写测试代码：

from django.test import TestCase
from django.core.management import call_command
from django.core.management.base import CommandError

class MigrationCheckTestCase(TestCase):
    def test_no_pending_migrations(self):
        try:
            # 执行makemigrations检查，--dry-run确保不会实际生成迁移文件
            call_command("makemigrations", "--check", "--dry-run")
        except CommandError as e:
            # 如果有未生成的迁移，命令会抛出异常，此时测试失败并提示原因
            self.fail(f"存在未生成的数据库迁移：{str(e)}")

方案二：通过迁移执行器底层检查 #

如果需要更灵活的自定义逻辑（比如针对多数据库检查），可以直接使用Django的MigrationExecutor操作迁移系统：

from django.test import TestCase
from django.db.migrations.executor import MigrationExecutor
from django.db import connections

class MigrationCheckTestCase(TestCase):
    def test_no_uncreated_migrations(self):
        # 遍历所有数据库连接（适配多数据库场景）
        for db_alias in connections:
            connection = connections[db_alias]
            executor = MigrationExecutor(connection)
            # 获取当前需要生成迁移的变更
            pending_migrations = executor.loader.detect_changes()
            
            self.assertEqual(
                len(pending_migrations),
                0,
                f"数据库[{db_alias}]存在未生成的迁移，请运行`python manage.py makemigrations`"
            )

注意事项 #

• 确保测试运行的数据库配置与开发环境一致，避免因数据库差异导致误判
• 可以将该测试放在项目核心app的测试目录或根测试目录中，确保测试套件运行时自动执行
• 若项目使用了第三方app的迁移，无需额外处理，Django会自动包含这些检查

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