Django报错TemplateDoesNotExist：/app/index.html问题求助

安全阿岳

2026-5-8

解决Django TemplateDoesNotExist 报错（访问/app/index.html时）

针对你遇到的这个问题，咱们一步步来排查和解决：

先确认模板文件的实际存放路径
从你的settings.py配置来看，TEMPLATES的DIRS里配置了两个路径：
- 项目根目录下的templates文件夹
- app/templates/app文件夹
  同时APP_DIRS = True，这意味着Django还会自动扫描每个已安装APP下的templates目录。
你需要对应检查index.html的位置：
- 如果模板放在**项目根目录/templates/**下，视图里应该用render(request, 'index.html')
- 如果模板放在**app/templates/**下，视图里用render(request, 'index.html')（因为APP_DIRS=True会自动找到这里）
- 如果模板放在**app/templates/app/**下，视图里必须用render(request, 'app/index.html')
验证BASE_DIR的正确性
有时候BASE_DIR的定义错误会导致路径拼接失效，你可以在settings.py里临时添加一行代码来打印实际路径：
```
print("BASE_DIR:", BASE_DIR)
```
启动服务器后看控制台输出，确认这个路径是你的项目根目录（也就是包含contactform、app这两个文件夹的上级目录）。如果不对，修正BASE_DIR的定义，通常正确的写法是：
```
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
```
检查视图中模板的引用是否正确
比如你的视图函数里，如果是这样写的：
```
def index(request):
    return render(request, 'index.html')
```
那对应的模板文件应该在上述提到的可被扫描到的路径里，否则就会报错。如果你的模板在app/templates/app/index.html，那视图里必须写成render(request, 'app/index.html')。
清除Django缓存
有时候缓存会导致模板路径不生效，运行以下命令清除缓存：
```
python manage.py clearcache
```
然后重启服务器再试。
检查文件权限（针对Linux/macOS）
确保服务器进程有读取模板文件和所在目录的权限，比如可以用以下命令赋予可读权限：
```
chmod -R 755 /path/to/your/project/templates
chmod -R 755 /path/to/your/project/app/templates
```