本文介绍如何通过自定义 admin 动作替代默认 delete_selected，实现在 django 后台批量删除确认页面（delete_selected_confirmation.html）中按条件动态渲染自定义警告消息，并安全注入上下文数据。
本文介绍如何通过自定义 admin 动作替代默认 `delete_selected`，实现在 django 后台批量删除确认页面（`delete_selected_confirmation.html`）中按条件动态渲染自定义警告消息，并安全注入上下文数据。
在 Django Admin 中，delete_selected 是内置的批量删除动作，其确认页面由 delete_selected_confirmation.html 渲染。但该动作不提供类似 render_delete_form() 的钩子方法来修改确认页上下文——ModelAdmin 类中并不存在直接对应 delete_selected_confirmation.html 的可覆写方法（如 render_delete_selected_confirmation）。因此，标准继承式扩展不可行，必须采用“动作替换”策略。
核心思路是：
✅ 移除默认 delete_selected 动作；
✅ 注册自定义动作，复用 Django 内置 delete_selected 逻辑；
✅ 在动作执行过程中拦截 GET 请求（即用户刚进入确认页时），根据业务逻辑动态计算并注入上下文变量（如 show_alarm、active_my_models）；
✅ 配合自定义模板，实现条件化警告展示。
✅ 实现步骤
- 复制并自定义模板
将 django/contrib/admin/templates/admin/delete_selected_confirmation.html 复制到项目模板目录（如 templates/admin/myapp/），确保 TEMPLATES[‘DIRS’] 已配置且优先级高于 Django 默认路径。在模板中添加条件渲染逻辑：
<!-- templates/admin/myapp/delete_selected_confirmation.html --> {% extends "admin/delete_selected_confirmation.html" %} {% block content %} {{ block.super }} {% if show_alarm %} <div class="errornote"> <h3>⚠️ 注意：以下对象处于活跃状态，删除将影响关联服务</h3> <ul> {% for obj in active_my_models %} <li>{{ obj }} (ID: {{ obj.pk }})</li> {% endfor %} </ul> </div> {% endif %} {% endblock %}- 在 ModelAdmin 中注册自定义动作
关键在于：调用 delete_selected(self, request, queryset) 获取原始 TemplateResponse，再在 request.POST.get(“post”) 为 None（即 GET 请求，尚未提交确认）时注入上下文：
# admin.py from django.contrib import admin from django.contrib.admin.actions import delete_selected from django.template.response import TemplateResponse from django.http import HttpRequest from django.db.models import QuerySet from .models import MyModel @admin.register(MyModel) class MyModelAdmin(admin.ModelAdmin): actions = ["delete_selected_my_models"] def get_actions(self, request): actions = super().get_actions(request) actions.pop("delete_selected", None) # 彻底移除默认动作 return actions def my_logic_comes_here(self, request: HttpRequest, obj: MyModel) -> bool: """自定义判断逻辑：例如检查 obj.is_active 或关联未完成任务""" return obj.is_active and obj.task_set.Filter(status="pending").exists() @admin.action(description="删除所选 MyModel 对象（含风险提示）") def delete_selected_my_models( self, request: HttpRequest, queryset: QuerySet[MyModel], ) -> TemplateResponse: # 复用 Django 原生逻辑生成确认响应 response = delete_selected(self, request, queryset) # 仅在 GET 请求（显示确认页）时注入动态上下文 if not request.POST.get("post"): show_alarm = False active_list = [] for obj in queryset: if self.my_logic_comes_here(request, obj): show_alarm = True active_list.append(obj) # 安全注入上下文（TemplateResponse.context_data 可读写） response.context_data["show_alarm"] = show_alarm response.context_data["active_my_models"] = active_list return response⚠️ 注意事项
- 不要修改 POST 流程：delete_selected() 在 POST 时会执行真实删除，此时不应干预上下文，否则可能破坏事务一致性；
- 性能考量：queryset 在确认页阶段尚未评估，for obj in queryset 会触发 N+1 查询。建议在 my_logic_comes_here 中使用 prefetch_related 或 select_related 优化，或改用 queryset.filter(…).values_list(‘pk’, flat=True) 批量预检；
- 权限校验：Django 默认在 delete_selected 中已校验 has_delete_permission，自定义动作无需重复处理；
- 模板路径优先级：确保自定义模板路径在 settings.TEMPLATES 中位于 django.contrib.admin 之前，否则 Django 仍加载默认模板。
✅ 总结
Django Admin 并未为 delete_selected_confirmation.html 提供直接的上下文扩展钩子，因此必须通过「动作替换 + 响应劫持」的方式实现动态提示。该方案完全兼容 Django 内置删除逻辑（包括中间件、信号、权限控制与事务管理），仅增强前端提示能力，兼具安全性与可维护性。适用于风控提示、依赖检查、审计日志预览等需用户知情确认的关键场景。