Django一对一关系下文件上传NoReverseMatch报错排查

问题梳理 #

• 业务逻辑：Rapports模型存储上传的PDF报告，通过OneToOneField与Stages模型做一对一关联，需要在指定Stage页面上传对应关联的报告
• 异常1：上传表单模板rapport/test.html的action属性配置URL传参时，触发NoReverseMatch，提示反向解析depo路由传入空参数，可匹配模式为rapport/(?P<pk>[0-9]+)\Z
• 异常2：手动填入固定ID访问上传页提交表单时，触发IntegrityError，提示NOT NULL约束失败：rapport_rapports.stage_id不能为空
• 已排查范围：导航入口模板、两个模型定义、表单类、视图代码、两级路由配置、带multipart/form-data编码的表单模板，stage.id在其他页面可正常传递

分步修复 #

1. 解决NoReverseMatch路由反向解析错误 #

该错误触发原因是模板中调用{% url %}标签时，未给depo路由传入要求的pk参数，或传入的参数值为空：

• 跳转到上传页的入口链接必须显式携带当前Stage的ID，示例写法：

  <a href="{% url 'depo' pk=stage.id %}">上传阶段报告</a>
  

• 上传表单的action属性不能留空、不能硬编码固定ID，需从模板上下文获取当前Stage的ID传入：

  <form method="POST" enctype="multipart/form-data" action="{% url 'depo' pk=stage.id %}">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">提交</button>
  </form>
  

• 视图层需要保证渲染模板时，上下文中存在确定的stage对象，而非空查询集：不要只传递全量Stages列表，要从URL捕获的pk参数取出当前操作对应的Stage对象传入模板。

2. 解决stage_id非空约束报错 #

CreateView默认不会自动绑定外键关联字段，即使URL传了正确的Stage ID，保存表单时也不会给stage_id赋值，需要手动在保存前绑定关联对象：

• 修改RapportsForm，将外键stage字段排除在用户可编辑字段外，避免前端篡改：

  from django import forms
  from .models import Rapports
  
  class RapportsForm(forms.ModelForm):
      class Meta:
          model = Rapports
          fields = ['pdf_file']  # 仅开放文件上传字段给用户填写
          exclude = ['stage']
  

• 重写CreateView的两个核心方法：get_context_data传入模板需要的stage对象，form_valid在表单保存前绑定关联的Stage实例：

  from django.shortcuts import get_object_or_404
  from django.views.generic.edit import CreateView
  from django.urls import reverse
  from .models import Rapports, Stages
  from .forms import RapportsForm
  
  class RapportUploadView(CreateView):
      model = Rapports
      form_class = RapportsForm
      template_name = 'rapport/test.html'
  
      def get_context_data(self, **kwargs):
          context = super().get_context_data(**kwargs)
          # 从URL提取pk，查询对应Stage传入模板
          context['stage'] = get_object_or_404(Stages, pk=self.kwargs['pk'])
          return context
  
      def form_valid(self, form):
          # 给外键字段赋值，解决NOT NULL约束报错
          current_stage = get_object_or_404(Stages, pk=self.kwargs['pk'])
          form.instance.stage = current_stage
          return super().form_valid(form)
  
      def get_success_url(self):
          # 上传完成后跳转回对应Stage详情页，可根据自身业务调整
          return reverse('stage_detail', kwargs={'pk': self.kwargs['pk']})
  

• 确认rapport应用路由配置正确，能够捕获整数类型的pk参数传给视图：

  from django.urls import path
  from . import views
  
  urlpatterns = [
      path('rapport/<int:pk>', views.RapportUploadView.as_view(), name='depo'),
  ]
  

补充说明：当前表单已配置enctype="multipart/form-data"，符合Django文件上传的要求，该部分不需要调整。

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