本文介绍如何通过自定义 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 内置删除逻辑（包括中间件、信号、权限控制与事务管理），仅增强前端提示能力，兼具安全性与可维护性。适用于风控提示、依赖检查、审计日志预览等需用户知情确认的关键场景。
