Django项目中template_name参数不生效问题求助

以下是排查和解决的关键步骤：

• 检查URL配置的参数传递方式
  确保在auth_views.PasswordChangeView.as_view()中正确传入template_name参数，正确写法示例：

  path('change-password/', auth_views.PasswordChangeView.as_view(template_name='reset_password.html'), name='password_change'),
  

  不要错误地将参数放在kwargs中，比如as_view(kwargs={'template_name': 'reset_password.html'})这种写法是无效的。

• 验证模板路径与文件名

  1. 确认reset_password.html确实位于authentication_system_app/templates/目录下，若模板在子目录（如templates/auth/reset_password.html），则template_name需写成auth/reset_password.html。
  2. 检查文件名拼写和大小写，Linux/macOS环境下区分大小写，避免出现Reset_Password.html这类大小写错误。

• 调整TEMPLATES配置的路径写法
  建议使用绝对路径避免相对路径问题，修改settings.py中的TEMPLATES配置：

  import os
  
  TEMPLATES = [
      {
          ...
          'DIRS': [os.path.join(BASE_DIR, 'authentication_system_app', 'templates')],
          ...
      },
  ]
  

  用BASE_DIR拼接绝对路径，可避免因项目运行路径不同导致的模板查找失败。

• 检查INSTALLED_APPS的顺序
  将authentication_system_app放在django.contrib.admin和django.contrib.auth之前，Django会按INSTALLED_APPS的顺序查找模板，避免优先加载Django自带的认证模板：

  INSTALLED_APPS = [
      'authentication_system_app',
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',
  ]
  

• 清除缓存并重启服务器
  Django可能缓存了旧的模板配置，执行以下操作：

  1. 停止当前Django开发服务器。
  2. 删除项目根目录下的__pycache__文件夹。
  3. 重新启动服务器：python manage.py runserver。

• 确认视图类型是否正确
  注意PasswordChangeView用于修改当前登录用户的密码，默认模板为registration/password_change_form.html；若要实现密码重置（发送邮件重置），应使用PasswordResetView，不要混淆两种视图的用途导致模板不匹配。

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