解决Django Admin按数据库值隐藏模型的CI构建报错问题

这个问题我之前在CI部署时也踩过坑——ready()方法是Django启动时就执行的，但CI环境下migrate是和启动环节分开（或启动后执行）的，这时候数据库表还没创建，直接查询MyModel肯定会报错。下面给你几个可行的解决思路，按推荐程度排序：

1. 推荐：重写ModelAdmin的has_module_permission方法（最优雅） #

不需要在ready()里做任何操作，而是通过自定义ModelAdmin来控制模型是否显示在Admin界面。核心逻辑是：Django Admin只会在用户实际访问Admin页面时调用has_module_permission方法，这时候CI已经完成migrate，数据库表已经存在了。

示例代码：

# foo/admin.py
from django.contrib import admin
from .models import ModelToHide, MyModel

class ModelToHideAdmin(admin.ModelAdmin):
    def has_module_permission(self, request):
        # 只有当MyModel存在符合条件的记录时，才显示该模型
        return MyModel.objects.filter(...).exists()

# 正常注册模型，绑定自定义的ModelAdmin
admin.site.register(ModelToHide, ModelToHideAdmin)

优点：

• 完全贴合Django Admin的设计逻辑，无需处理数据库初始化时机问题
• 查询仅在用户访问Admin时执行，不会影响Django启动性能
• 逻辑简洁，后续维护成本低

2. 检查数据库表是否存在后再执行查询 #

如果必须在ready()方法里处理，可以先判断MyModel的表是否已创建，再执行exists()查询。Django提供了数据库表存在性检查的工具：

示例代码：

# foo/apps.py
from django.apps import AppConfig
from django.db import connection
from django.contrib import admin

class FooConfig(AppConfig):
    name = 'foo'
    # 标记是否已处理过，避免ready()多次调用重复执行逻辑
    _processed = False

    def ready(self):
        if self._processed:
            return
        
        from .models import MyModel, ModelToHide
        
        # 检查MyModel对应的数据库表是否存在
        with connection.cursor() as cursor:
            table_names = connection.introspection.table_names(cursor)
            table_exists = MyModel._meta.db_table in table_names
        
        if table_exists:
            if MyModel.objects.filter(...).exists():
                try:
                    admin.site.unregister(ModelToHide)
                except admin.sites.NotRegistered:
                    # 避免重复unregister触发报错
                    pass
        
        self._processed = True

注意：

• 若项目使用多数据库，需要指定对应connection（比如connection['default']）
• ready()方法可能被Django多次调用（比如runserver自动重载时），需加_processed标记避免重复操作

3. 监听post_migrate信号，在migrate完成后处理 #

利用Django的post_migrate信号，该信号会在migrate命令执行完成后触发，此时数据库表已全部创建完毕，适合执行依赖数据库的初始化逻辑：

示例代码：

# foo/apps.py
from django.apps import AppConfig

class FooConfig(AppConfig):
    name = 'foo'

    def ready(self):
        # 注册信号接收器，避免循环导入
        from . import signals

# foo/signals.py
from django.contrib import admin
from django.db.models.signals import post_migrate
from django.dispatch import receiver
from .models import MyModel, ModelToHide

@receiver(post_migrate)
def adjust_admin_models(sender, **kwargs):
    # 确保只处理当前应用的migrate事件
    if sender.name != 'foo':
        return
    
    if MyModel.objects.filter(...).exists():
        try:
            admin.site.unregister(ModelToHide)
        except admin.sites.NotRegistered:
            # 忽略未注册的情况，避免报错
            pass

优点：

• 确保仅在数据库表全部创建完成后执行逻辑
• 适合需要一次性调整Admin配置的场景

缺点：

• 信号会在每次migrate时触发，需处理重复执行的问题（比如用try-except捕获NotRegistered异常）

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