django-autocomplete-light配置GenericForeignKey报无效视图错误

使用django-autocomplete-light搭建GenericForeignKey自动补全功能时，访问对应表单触发invalid view function报错，报错截图如下：

项目核心配置如下：

• models.py

class Prereq(IsAPrereqMixin, models.Model):
    name = models.CharField(max_length=256, null=True, blank=True)

    prereq_content_type = models.ForeignKey(ContentType, related_name='prereq_item',
                                            verbose_name="Type of Prerequisite",
                                            on_delete=models.CASCADE)
    prereq_object_id = models.PositiveIntegerField(verbose_name="Prerequisite")
    prereq_object = GenericForeignKey("prereq_content_type", "prereq_object_id")

    # 其余无关字段已省略

• forms.py

from dal import autocomplete
from prerequisites.models import Prereq

class PrereqForm(autocomplete.FutureModelForm):

    prereq_object = autocomplete.Select2GenericForeignKeyModelField(
        model_choice=[(Prereq, "Prereq"), ]
    )

    class Meta:
        model = Prereq
        fields = ['name']

• urls.py

from django.urls import path

from prerequisites import views
from prerequisites.forms import PrereqForm

app_name = 'prerequisites'

urlpatterns = [
    path('edit/<int:pk>/', views.PrereqUpdateView.as_view(), name='prereq_edit'),
]

# 注册DAL自动补全路由
urlpatterns.extend(PrereqForm.as_urls())

报错的核心诱因是子应用设置了app_name路由命名空间：PrereqForm.as_urls()自动生成的自动补全路由，默认会被注册到当前子应用的命名空间下，但DAL内部做路由反向解析时，默认查找的是不带任何命名空间前缀的补全接口路径，二者匹配失败就会抛出视图函数无效的错误。

两种方案均可解决问题，按需选择即可：

• 方案1：将DAL自动补全路由迁移到项目根路由表注册
  这是DAL官方推荐的通用做法，自动补全接口本身是全局通用组件，放在根路由下不会受任何子应用命名空间影响。
  操作步骤：
  1. 删除子应用prerequisites/urls.py中最后一行urlpatterns.extend(PrereqForm.as_urls())代码
  2. 打开项目全局根urls.py，导入PrereqForm后将自动补全路由追加到根路由表，参考代码：

     # 项目根urls.py
     from django.urls import path, include
     from prerequisites.forms import PrereqForm
     
     urlpatterns = [
         # 原有其他根路由配置，例如后台、子应用路由挂载
         path('prerequisites/', include('prerequisites.urls')),
     ]
     # 注册DAL自动补全路由
     urlpatterns.extend(PrereqForm.as_urls())
     

• 方案2：保留路由在子应用下，手动指定补全接口的命名空间路径
  如果不想改动根路由，可以在定义自动补全字段时，显式传入带命名空间的反向路由地址，让DAL能正确匹配到子应用下的补全接口。
  操作步骤：
  1. 修改forms.py中的自动补全字段配置，增加url参数指定带命名空间的路由名
  2. 保留子应用urls.py中原有的urlpatterns.extend(PrereqForm.as_urls())配置即可，参考代码：

     # prerequisites/forms.py
     from dal import autocomplete
     from prerequisites.models import Prereq
     
     class PrereqForm(autocomplete.FutureModelForm):
         prereq_object = autocomplete.Select2GenericForeignKeyModelField(
             model_choice=[(Prereq, "Prereq"), ],
             # 显式指定带prerequisites命名空间的自动补全路由
             url='prerequisites:autocomplete-prereq'
         )
     
         class Meta:
             model = Prereq
             fields = ['name']
     

注意：上述代码中autocomplete-prereq是DAL为Prereq模型生成的补全接口默认路由名，如果调用as_urls()时传入了自定义前缀参数，需要同步修改这里的路由名。

配置修改完成后，重启Django服务、清空浏览器缓存后重新访问表单页，自动补全请求即可正常路由到对应视图，报错会完全消失。

内容的提问来源于stack exchange，提问作者43Tesseracts