Django 4.0.6部署PythonAnywhere遇TemplateDoesNotExist错误求助

排查步骤与解决方法 #

1. 验证BASE_DIR与模板目录路径的正确性 #

在PythonAnywhere的控制台中执行以下命令，确认模板目录是否存在：

python manage.py shell

在shell中输入：

import os
from django.conf import settings
print(settings.BASE_DIR)
# 检查模板目录是否存在
print(os.path.exists(os.path.join(settings.BASE_DIR, 'frontend/build')))

• 如果返回False，说明路径错误：可能是frontend目录的位置不对（比如在子app目录下而非项目根目录），或者拼写错误（Linux环境大小写敏感）。

2. 确认index.html的存在与权限 #

• 登录PythonAnywhere的文件管理器，直接查看frontend/build目录下是否有index.html，注意文件名大小写（比如Index.html无法被识别为index.html）。
• 确保文件权限允许Django进程读取，执行命令修改权限：

chmod -R 755 /home/你的用户名/项目路径/frontend/build
chmod 644 /home/你的用户名/项目路径/frontend/build/index.html

3. 检查WSGI文件的工作目录配置 #

打开PythonAnywhere中的WSGI配置文件，确认项目路径设置正确：

import os
import sys

# 替换为你的项目绝对路径
project_path = '/home/你的用户名/你的项目目录'
if project_path not in sys.path:
    sys.path.append(project_path)

os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名称.settings')

如果工作目录错误，BASE_DIR的计算会出错，导致模板目录无法被找到。

4. 确认模板调用方式正确 #

视图中调用模板时，直接使用index.html即可，无需添加路径前缀：

from django.shortcuts import render

def home(request):
    return render(request, 'index.html')

因为TEMPLATES的DIRS已经指定了frontend/build，Django会自动在该目录下查找模板文件。

5. 查看Django模板的实际查找路径 #

可以在视图中临时添加调试代码，查看Django尝试查找的模板路径：

from django.template.loader import get_template
from django.template.exceptions import TemplateDoesNotExist

def home(request):
    try:
        template = get_template('index.html')
        print("找到的模板路径:", template.origin.name)
    except TemplateDoesNotExist as e:
        print("模板查找失败，尝试的路径:", e)
    return render(request, 'index.html')

运行后查看PythonAnywhere的日志，确认是否包含frontend/build目录。

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