Django Web应用出现TemplateDoesNotExist错误，登录页无法加载

1. 确认APP配置与模板搜索规则 #

首先检查settings.py里的INSTALLED_APPS是否包含你的main应用，只有添加后Django才会搜索该app下的模板目录：

# settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'main',  # 必须存在这一行
]

同时确保TEMPLATES配置中的APP_DIRS设为True，开启app内模板目录的自动搜索：

# settings.py
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,  # 保持为True
        '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',
            ],
        },
    },
]

2. 修正模板路径匹配 #

Django默认登录视图会查找registration/login.html，但你的模板放在main/templates/main/registration/login.html，相当于模板的完整路径是main/registration/login.html，可以二选一解决：

• 移动模板位置：把login.html移到main/templates/registration/目录下，直接匹配默认路径。
• 显式指定模板路径：在URL配置里给登录视图指定模板名称：

# urls.py（项目或app的urls文件）
from django.contrib.auth import views as auth_views

urlpatterns = [
    # 其他URL配置...
    path('login/', auth_views.LoginView.as_view(template_name='main/registration/login.html'), name='login'),
]

3. 清除缓存并重启服务 #

Django可能缓存了旧的模板路径，执行以下命令清除缓存：

python manage.py clearcache

之后重启开发服务器，确保新配置生效。

4. 验证模板搜索路径 #

如果以上步骤无效，可以在shell里打印Django的模板搜索路径，确认是否包含main/templates：

# 运行python manage.py shell后执行
from django.template.loader import get_template_loader
loader = get_template_loader('django')
print("当前模板搜索路径：", loader.get_dirs())

如果输出里没有main/templates，说明APP配置或目录结构存在问题，需要重新检查。

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