Django分类与子分类模型异常：Admin面板无响应无法操作

看起来你遇到的是Django Admin处理层级分类时常见的性能/递归问题，我来帮你一步步排查和解决：

1. 先检查Category模型的__str__方法 #

最容易踩坑的就是递归调用的__str__，比如如果你的代码是这样的：

class Category(models.Model):
    name = models.CharField(max_length=100)
    parent = models.ForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, related_name='children')

    def __str__(self):
        return f"{self.parent} > {self.name}"  # 这里会递归调用父分类的__str__

当你保存子分类后，Admin渲染时会无限递归解析__str__，直接导致进程卡死。

修复方案：
改成非递归的实现，比如只返回分类名称，或者用循环生成路径（避免无限递归）：

def __str__(self):
    # 简单版：只返回当前分类名
    return self.name

# 或者带路径但非递归的版本
def __str__(self):
    path = [self.name]
    current_parent = self.parent
    # 限制循环次数，防止极端情况
    for _ in range(10):
        if not current_parent:
            break
        path.append(current_parent.name)
        current_parent = current_parent.parent
    return ' > '.join(reversed(path))

2. 优化Category的Admin配置 #

默认的Admin表单会渲染所有分类的下拉选项，当分类有层级时，这个下拉会加载大量数据甚至触发递归查询，直接卡死页面。

修复方案：
修改admin.py里的CategoryAdmin配置，用raw_id_fields替代默认的下拉，或者限制可选的父分类范围：

from django.contrib import admin
from .models import Category, Posts

class CategoryAdmin(admin.ModelAdmin):
    # 用ID输入框替代下拉，避免加载所有分类选项
    raw_id_fields = ('parent',)
    # 可选：只允许选择顶级分类作为父分类（根据你的需求调整）
    # limit_choices_to = {'parent__isnull': True}
    # 优化列表页查询，减少数据库访问
    list_display = ('name', 'parent')
    list_select_related = ('parent',)

admin.site.register(Category, CategoryAdmin)
admin.site.register(Posts)

3. 排查是否有无限递归的信号或事务 #

如果你给Category模型加了post_save信号，一定要检查信号函数里有没有重复调用instance.save()，比如：

# 错误示例：会触发无限循环的信号
@receiver(post_save, sender=Category)
def update_category(sender, instance, **kwargs):
    instance.save()  # 这里会再次触发post_save信号，无限循环

修复方案：
给信号加条件判断，比如只在创建时执行，或者避免在信号里调用save：

@receiver(post_save, sender=Category)
def update_category(sender, instance, created, **kwargs):
    if created:
        # 只在创建新分类时执行操作，避免更新时触发循环
        pass

4. 检查前端控制台错误 #

有时候Admin卡死是因为前端JS处理大量选项时崩溃，打开浏览器开发者工具（F12）的Console面板，看看有没有内存溢出、JS报错等信息，这能帮你快速定位是前端还是后端的问题。

先从上面这几个方向排查，大部分情况下都是__str__递归或者Admin表单加载数据过多导致的问题，调整后应该就能恢复正常了。

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