Django Admin自定义跳转按钮失效，无法打开目标模型表单

1. 校验URL路由配置 #

• 确认create_act方法对应的URL已正确注册，且处于Admin命名空间下
  • 示例正确路由写法：

    # urls.py
    from django.urls import path
    from .admin import BaseFundElementAdmin
    
    urlpatterns = [
        # ... 其他路由
        path('admin/fundelement/<int:pk>/create-act/', BaseFundElementAdmin.create_act, name='create-act'),
    ]
    

• 模板中跳转需使用Admin命名空间，例如：{% url 'admin:create-act' object.pk %}，避免直接写硬编码URL

2. 检查自定义模板的按钮代码 #

• 确认按钮的跳转目标URL生成正确，示例正确写法：

  <!-- 自定义change_form.html模板 -->
  {% block object-tools-items %}
      {{ block.super }}
      <li>
          <a href="{% url 'admin:create-act' object.pk %}" class="button">创建核销单</a>
      </li>
  {% endblock %}
  

• 验证模板是否正确继承Admin基础模板（如{% extends 'admin/change_form.html' %}），且按钮插入到了正确的区块中

3. 排查create_act视图方法逻辑 #

• 确认方法能正确返回WriteOffAct的创建表单响应，示例正确结构：

  # admin.py
  from django.shortcuts import render, redirect
  from .models import WriteOffAct
  from .forms import WriteOffActForm
  
  class BaseFundElementAdmin(admin.ModelAdmin):
      # ... 其他配置
      def create_act(self, request, pk):
          fund_element = self.get_object(request, pk)
          act = WriteOffAct(fund_element=fund_element)
          
          if request.method == 'POST':
              form = WriteOffActForm(request.POST, instance=act)
              if form.is_valid():
                  form.save()
                  return redirect('admin:yourapp_fundelement_change', pk=pk)
          else:
              form = WriteOffActForm(instance=act)
          
          return render(request, 'admin/writeoffact/create_form.html', {
              'form': form,
              'opts': WriteOffAct._meta,
              'title': '创建核销单',
          })
  

• 检查方法是否有权限控制逻辑，避免拦截合法请求

4. 验证权限与CSRF设置 #

• 确认当前登录用户拥有WriteOffAct模型的添加权限，Django Admin会自动拦截无权限的请求
• 若使用POST方式跳转，需确保表单中包含CSRF令牌（建议跳转用GET方式更简单）

5. 浏览器端调试 #

• 打开浏览器开发者工具，查看控制台是否有JS报错，或网络请求是否返回404/403状态码
• 检查按钮的实际href属性值，确认参数和路径是否与预期一致

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