无需重启服务器，删除Django模型文件后如何触发迁移？

问题核心在于Django和Python的多层缓存机制，光删除文件、更新__init__.py或重载模块根本清不干净残留的模型引用，主要缓存点包括：

• Django Apps Registry：全局django.apps.apps对象会在启动时注册所有模型，默认不会自动刷新，即便删除了文件，它仍会保留旧模型的记录
• Python模块缓存：除了my_app.models，被删除的my_app.models.my_model模块本身也可能留在sys.modules中，未被彻底清理
• 模型关联缓存：若其他模型和被删模型有外键/关联关系，反向引用的缓存也会残留

无需重启服务器的解决步骤 #

1. 彻底清理相关模块的Python缓存
2. 重置Django的应用注册器，清空模型缓存
3. 强制重新加载目标应用的模型配置
4. 再执行迁移命令

修改后的代码示例 #

import os
import sys
import importlib
from django.apps import apps
from django.core.management import call_command

# 删除模型文件
file_path = 'my_app/models/my_model.py'
if os.path.exists(file_path):
    os.remove(file_path)

# 更新__init__.py，移除模型引用
init_file_path = 'my_app/models/__init__.py'
with open(init_file_path, 'r') as file:
    lines = file.readlines()

with open(init_file_path, 'w') as file:
    for line in lines:
        if 'my_model' not in line:
            file.write(line)

# 彻底清理sys.modules中的相关模块
modules_to_clear = [
    'my_app.models',
    'my_app.models.my_model'
]
for mod_name in modules_to_clear:
    if mod_name in sys.modules:
        del sys.modules[mod_name]

# 重置Django Apps Registry，清空模型缓存
apps.clear_cache()
# 重新加载目标应用的模型配置
for app_config in apps.get_app_configs():
    if app_config.label == 'my_app':
        app_config.import_models()

# 重新导入模块
importlib.import_module('my_app.models')

# 执行迁移
call_command('makemigrations', 'my_app')
call_command('migrate', 'my_app')

关键说明 #

• apps.clear_cache()会清空Django的模型注册缓存，让它重新扫描应用的模型文件
• 单独清理my_app.models.my_model模块，避免Python残留旧模块的引用
• 手动调用app_config.import_models()，强制目标应用重新加载所有模型定义

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