PythonAnywhere部署Django项目时遭遇模板错误求助

部署Django项目到PythonAnywhere时遇到模板加载错误，本地环境下模板路径配置正常，线上却报错。

本地配置信息 #

# 本地TEMPLATES配置（正常工作）
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [r'C:\Users\CODED\Desktop\direct-parcel-delivery-service\service\templates'],
        # 其他配置项省略
    },
]

视图代码 #

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

def Register(request):
    form = Packageform()
    if request.method == 'POST':
        form = Packageform(request.POST or None)
        if form.is_valid():
            form.save()                   
            return redirect('home')    
        else:
            return redirect('register')
    else:
        return render(request, 'service/register.html', {'form': form})

解决办法 #

1. 替换硬编码绝对路径为跨平台相对路径 #

Windows的绝对路径在Linux环境的PythonAnywhere完全无效，改用BASE_DIR拼接相对路径，适配所有环境：

import os
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'service', 'templates')],
        'APP_DIRS': True,  # 确保此项为True，Django会自动搜索app内的templates目录
        # 其他配置保持不变
    },
]

2. 检查模板文件的存在性与大小写 #

Linux环境区分文件名大小写，Windows不区分：

• 确认PythonAnywhere项目中service/templates/service/home.html和service/templates/service/register.html文件存在
• 确保文件名和代码中引用的完全一致（比如不要写成Home.html）

3. 验证PythonAnywhere部署配置 #

• 确认虚拟环境已安装所有依赖（执行pip install -r requirements.txt）
• 检查WSGI配置文件中是否正确指向项目settings（比如os.environ.setdefault("DJANGO_SETTINGS_MODULE", "your_project_name.settings")）
• 修改配置后重启PythonAnywhere的Web服务，确保配置生效

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