Django Admin 的批量删除动作默认只会显示一句 Are you sure? 和待删除对象列表。业务系统里，删除订单、账号或财务记录时，往往需要根据数据状态给出额外提醒，例如已支付记录不可轻易删除、关联优惠券会一并解除等。本文会拆解默认删除动作到达确认页的过程，再用自定义动作注入上下文和模板覆盖两种方式，把动态警告放进确认页。
一、默认批量删除流程与确认页上下文
在 Django Admin 的变更列表页勾选若干对象，选择删除所选动作并提交后，默认的 delete_selected 动作并不会立刻删除数据。它先调用 get_deleted_objects 计算每个对象可能级联删除或受保护的内容，然后返回一个 TemplateResponse，渲染后台模板 admin/delete_selected_confirmation.html。
这个确认页模板能使用 queryset、objects_name、deletable_objects、perms_lacking、protected 等变量。其中的 perms_lacking 和 protected 分别表示权限不足和外键保护的对象，模板会根据它们展示不可删除的原因。动态定制警告的关键点就在这里：只要让自定义动作返回同一个模板，并向模板上下文里多塞一个变量，确认页就能显示不同文案。
理解这个流程后，就能避免直接修改 Django 源码。下面先看最直接的方案：自定义管理动作替换默认删除动作，并注入 warning_message。
二、自定义动作注入动态警告消息
自定义动作需要同时兼顾两个阶段：第一次提交时显示确认页，用户真正确认后再执行删除。默认模板提交确认表单时会带上 post=yes 字段，因此可以在动作函数里通过 request.POST.get('post') 判断是否进入删除阶段。若没有该字段，就走确认流程；若存在，就执行 queryset.delete() 并返回 None。
删除影响的计算可以直接复用 Django 提供的 get_deleted_objects 工具函数，它返回 (deletable_objects, model_count, perms_needed, protected)。这样自定义动作不用重写级联删除的汇总逻辑，默认确认页需要的 deletable_objects、perms_lacking 和 protected 也都能原样传给模板。下面是一个完整示例：
from django.contrib import admin
from django.contrib.admin import actions
from django.contrib.admin.utils import get_deleted_objects, model_ngettext
from django.template.response import TemplateResponse
def delete_selected_with_warning(modeladmin, request, queryset):
if request.POST.get('post'):
deleted = queryset.count()
queryset.delete()
modeladmin.message_user(request, f"已删除 {deleted} 条记录")
return None
opts = modeladmin.model._meta
deletable_objects, model_count, perms_needed, protected = get_deleted_objects(
queryset, request, modeladmin.admin_site
)
paid_count = queryset.filter(status='paid').count()
if paid_count:
warning_message = f"当前所选对象中包含 {paid_count} 条已支付记录，删除后无法恢复，请谨慎确认。"
else:
warning_message = "删除后数据将从系统中移除，如需保留请取消本次操作。"
context = {
**modeladmin.admin_site.each_context(request),
'title': '确认删除',
'objects_name': model_ngettext(opts, queryset.count()),
'deletable_objects': [deletable_objects],
'model_count': dict(model_count).items(),
'queryset': queryset,
'perms_lacking': perms_needed,
'protected': protected,
'opts': opts,
'action_checkbox_name': actions.ACTION_CHECKBOX_NAME,
'media': modeladmin.media,
'warning_message': warning_message,
}
return TemplateResponse(
request,
'admin/custom_delete_selected_confirmation.html',
context,
)
delete_selected_with_warning.short_description = '删除所选（含业务警示）'
在 ModelAdmin 中把 actions 设置成只包含这个新动作，即可替换默认的删除行为。注意 get_deleted_objects 返回的删除对象是嵌套列表，传给模板时需要再包一层 [deletable_objects]，否则模板里的遍历层级会不一致。另外 model_count 是字典，不能直接迭代，要转换成 dict(model_count).items()。
from django.contrib import admin
from .models import Order
@admin.register(Order)
class OrderAdmin(admin.ModelAdmin):
actions = [delete_selected_with_warning]
这段代码只展示了替换动作的入口，实际项目中还可以把动作函数改写成 OrderAdmin 的方法，方便访问模型级配置和其他业务方法。
三、模板继承控制提示位置
动作函数返回的模板是 admin/custom_delete_selected_confirmation.html，建议把它放在项目模板目录 templates/admin/ 下。模板主体不用重写，直接继承默认的 admin/delete_selected_confirmation.html 即可。只需要覆盖 content 块，先输出动态警告，再通过 {{ block.super }} 保留默认确认流程。
这样做有两个好处：一是父模板仍然负责渲染对象列表、权限错误和外键保护等内容，避免复制大段官方模板；二是如果 Django 后续调整默认模板的非关键结构，只要块名不变，继承方案仍能继续工作。下面给出模板内容：
{% extends "admin/delete_selected_confirmation.html" %}
{% load i18n l10n admin_urls %}
{% block content %}
{% if warning_message %}
<div style="margin-bottom:15px;padding:12px;border:1px solid #f0ad4e;background:#fcf8e3;color:#8a6d3b;border-radius:3px;">
<strong>操作提示：</strong>{{ warning_message }}
</div>
{% endif %}
{{ block.super }}
{% endblock %}
模板中的 warning_message 正是动作函数注入的上下文变量。由于 {% if warning_message %} 在变量缺失时不会报错，后续即使某些条目走默认删除动作、没有该变量，模板也不会异常。提示样式使用内联 style，方便快速看到效果；如果后台有统一的设计规范，可以替换成项目自定义 CSS 类。
需要特别留意模板命名冲突：如果你已经在 templates/admin/ 下放置了同名文件 delete_selected_confirmation.html，再继承 admin/delete_selected_confirmation.html 就会加载到项目覆盖后的文件，可能造成继承自己或内容不符。因此自定义动作应指向独立模板名，而不是直接覆盖默认确认页，除非你明确要统一改动所有删除确认场景。
四、拆分警告逻辑与边界处理
当警告规则逐渐变多时，把 if queryset.filter(...) 堆在动作函数里会难以维护。更推荐在 ModelAdmin 中定义一个 get_bulk_delete_warning 方法，专门根据 request 和 queryset 生成提示文本。动作函数只负责调用它并注入上下文，这样规则修改和动作生命周期完全分离，也方便单独测试。
例如，在 OrderAdmin 中增加以下方法：
def get_bulk_delete_warning(self, request, queryset):
warnings = []
paid_count = queryset.filter(status='paid').count()
if paid_count:
warnings.append(f"包含 {paid_count} 条已支付记录，删除后无法恢复。")
if queryset.filter(coupon__isnull=False).exists():
warnings.append("部分记录已关联优惠券，删除将同步解除关联。")
return " ".join(warnings)
然后把动作函数中生成 warning_message 的代码替换成 warning_message = modeladmin.get_bulk_delete_warning(request, queryset)。这种方式也便于在规则复杂时编写单元测试：传入不同的 queryset 和模拟用户，断言返回的提示文案是否包含关键信息。
还需要明确一点：警告只负责提醒，不能替代硬性校验。如果某些记录完全不允许删除，应在动作函数中检测并提前返回错误页面，或重写 ModelAdmin.has_delete_permission、delete_queryset 来阻止删除。否则用户仍然可以点击确认绕过提示。默认模板在检测到 perms_lacking 或 protected 时会显示不可删除信息，这些逻辑应当保留在上下文中，不要因为自定义提示而省略相关变量。
最后，上线前记得在测试环境验证两条路径：第一次提交必须显示确认页和动态警告，点击确认后数据真正被删除；权限不足或外键保护时，页面应仍然展示默认错误信息，而不是只显示自定义提示。
Django Admin批量删除警告提示修改时间：2026-09-23 20:19:34