Django Admin重写delete_queryset后如何修改其short_description

为什么自定义short_description不生效 #

• 普通自定义Admin action之所以可以通过挂载short_description生效，是因为框架会自动把类上定义的对应方法注册到操作列表，注册时直接读取方法本身的short_description属性作为下拉框的展示文案
• Django Admin 的内置批量删除入口是固定名为delete_selected的action，不属于这个自动注册流程。框架在加载action列表时，会硬编码为这个action设置默认展示文案，这个action的处理函数是框架内部导入的固定方法，并非你重写的delete_queryset，自然完全不会读取你挂在delete_queryset上的自定义属性
• 完整调用链逻辑：delete_selectedaction负责操作展示、跳转删除二次确认页，用户确认删除后才会调用当前ModelAdmin实例的delete_queryset方法执行实际删除操作。也就是说delete_queryset只是删除流程的中间执行环节，和action下拉框的展示文案没有直接关联
• 你之前在__init__中尝试删除实例的delete_queryset会触发AttributeError，是因为该方法是定义在ModelAdmin父类上的类级方法，并非实例绑定属性，实例本身不存在这个属性，自然无法执行删除操作

方案一：覆写get_actions方法直接修改展示文案（推荐，无流程侵入） #

保留你已经实现的自定义delete_queryset逻辑，仅在框架生成action列表的最终环节替换对应文案，完全不改动原有删除流程（包括二次确认页、权限校验等内置安全逻辑）

class MyAdminModel(admin.ModelAdmin):
    # 保留你原本的自定义批量删除逻辑
    def delete_queryset(self, request, queryset):
        # 你的自定义删除处理，比如软删除、操作日志记录等
        super().delete_queryset(request, queryset)

    def get_actions(self, request):
        actions = super().get_actions(request)
        # 定位到内置的批量删除action条目，actions的条目结构为 (处理函数, action标识, 展示文案)
        if "delete_selected" in actions:
            func, action_slug, _ = actions["delete_selected"]
            # 替换为你需要的自定义展示文案
            actions["delete_selected"] = (func, action_slug, "批量删除业务数据")
        return actions

方案二：自定义delete_selectedaction打通原有流程 #

直接在当前ModelAdmin类中定义自己的delete_selected方法，内部调用框架原生的删除action逻辑，这样框架就会自动识别这个类方法，和普通自定义action一样读取你挂载在方法上的short_description作为展示文案

class MyAdminModel(admin.ModelAdmin):
    def delete_queryset(self, request, queryset):
        # 你的自定义删除逻辑
        pass

    def delete_selected(self, request, queryset):
        # 导入框架原生的删除action逻辑，完全保留原有流程
        from django.contrib.admin.actions import delete_selected as native_delete
        return native_delete(self, request, queryset)
    # 自定义展示文案的挂载方式和普通自定义action完全一致
    delete_selected.short_description = "批量删除业务数据"

• 上述两种方案都不会破坏原有批量删除的权限校验、二次确认等安全逻辑，仅替换下拉框中的展示文案
• 不要尝试在实例__init__阶段修改类级方法的属性，这类操作很容易因为方法解析顺序问题导致全局逻辑污染，优先通过框架暴露的扩展点（比如get_actions）做定制

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