Django LoginView模板不存在异常：部分场景失效求助

1. 检查URL配置是否覆盖默认登录路由 #

Django默认的登录URL（accounts/login/）若未被自定义LoginView覆盖，权限校验跳转时会调用默认视图，而默认视图的模板路径是registration/login.html。

确保urls.py配置如下：

from django.contrib.auth.views import LoginView

urlpatterns = [
    # 自定义登录视图，指定template_name并设置name为login
    path('accounts/login/', LoginView.as_view(template_name='accounts/login.html'), name='login'),
    # 其他路由...
]

重点是必须指定name='login'——Django权限装饰器（如@login_required）会默认调用名为login的路由，若自定义视图未设置该name，权限跳转仍会走默认视图。

2. 确认LOGIN_URL设置指向自定义路由 #

检查settings.py中的LOGIN_URL，确保它指向你的自定义登录路由：

LOGIN_URL = 'login'  # 使用路由name比硬编码路径更可靠
# 或直接写路径：LOGIN_URL = '/accounts/login/'

该配置控制权限校验失败时的跳转地址，若指向默认视图，会自动使用默认模板路径。

3. 排查自定义LoginView的重写问题 #

如果是继承LoginView实现的自定义视图，确保未错误覆盖模板配置：

• 若类视图直接指定模板：

from django.contrib.auth.views import LoginView

class CustomLoginView(LoginView):
    template_name = 'accounts/login.html'  # 明确指定自定义模板路径

• 若重写了get_template_names()方法，确保返回正确路径：

def get_template_names(self):
    return ['accounts/login.html']  # 不要返回默认的registration/login.html

4. 验证模板目录搜索配置 #

再次确认模板相关配置：

• 确保accounts/login.html放在项目根目录的templates文件夹下（如/templates/accounts/login.html）
• settings.py的TEMPLATES配置中，DIRS包含模板根目录，APP_DIRS设为True：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],
        'APP_DIRS': True,
        'OPTIONS': {
            # 其他配置...
        },
    },
]

5. 清除Django缓存 #

开发环境下修改配置后，可能存在模板路径缓存，重启Django服务器，或执行命令清除缓存：

python manage.py clearcache

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