Django应用点击添加记录报错：join()参数不能为NoneType

点击Add a Record按钮时，应用抛出错误：join() argument must be str, bytes, or os.PathLike object, not 'NoneType'，但视图代码里并没有手动做路径拼接操作。对应的视图代码如下：

def add_job_record(request):
    add_form = AddJobTrackerForm(request.POST or None)
    if request.user.is_authenticated:
        if request.method == "POST":
            if add_form.is_valid():
                add_job_record = add_form.save()
                messages.success(request, 'Job Tracker added')
                return redirect('core:home')
        return render(request, 'applications/add_record.html', {'add_form': add_form})
    else:
        messages.danger(request, "You must be logged in")
        return redirect('core:home')

曾尝试移除上下文里的{'add_form': add_form}，但页面直接无法显示表单，完全没用。

错误根源分析 #

看错误回溯信息，最终报错点在safe_join(template_dir, template_name)，说明Django在渲染表单组件的模板时，找不到有效的模板目录（template_dir是None）。大概率是以下几种情况：

解决步骤 #

• 检查表单类的自定义Widget
  如果你在AddJobTrackerForm里自定义了Widget，检查是否错误地将template_name设为了None，比如：

  class CustomInputWidget(forms.TextInput):
      template_name = None  # 这里是错误的，要改成具体的模板路径，比如'widgets/custom_input.html'
  

  或者继承内置Widget时，有没有覆盖template_name导致路径丢失。

• 验证项目模板配置
  确保settings.py里的INSTALLED_APPS包含你的applications应用，并且TEMPLATES配置里开启了APP_DIRS：

  INSTALLED_APPS = [
      # 其他应用
      'applications',
  ]
  
  TEMPLATES = [
      {
          'BACKEND': 'django.template.backends.django.DjangoTemplates',
          'DIRS': [],  # 如果有自定义模板目录可以加在这里
          'APP_DIRS': True,  # 必须设为True，让Django自动搜索各app的templates目录
          'OPTIONS': {
              'context_processors': [
                  'django.template.context_processors.debug',
                  'django.template.context_processors.request',
                  'django.contrib.auth.context_processors.auth',
                  'django.contrib.messages.context_processors.messages',
              ],
          },
      },
  ]
  

  因为Django默认会去每个已安装app的templates目录找表单组件的默认模板，如果APP_DIRS没开或者app没装，就会找不到模板路径导致报错。

• 检查表单字段的Widget使用
  确认表单里的字段有没有误用Widget的情况，比如传递错误的参数给内置Widget，导致其模板路径失效。

注意 #

之前看到的移除{'add_form': add_form}的建议完全错误，模板依赖这个上下文变量来渲染表单，移除后自然看不到表单，而且根本没触及问题根源。

内容的提问来源于stack exchange，提问作者Vicente Antonio G. Reyes