本地/Docker环境下Django未使用Jinja2渲染模板问题求助

使用Django搭配Jinja2开发时，本地及Docker环境下Jinja2模板引擎无法正常渲染模板，但相同代码在Github Codespaces中可正常运行。具体报错信息：

TemplateSyntaxError at /val/
Could not parse the remainder: '('valapp:engindex', args=[engagement.id])' from 'url('valapp:engindex', args=[engagement.id])'

相关配置代码 #

settings.py 模板配置 #

TEMPLATES = [
    {
        "BACKEND": "django_jinja.backend.Jinja2",
        "DIRS": [
            os.path.join(BASE_DIR, 'templates')
        ],
        "APP_DIRS": True,
        "OPTIONS": {
            "environment": 'valuation.jinja2.environment',
        }
    },
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': 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',
            ],
        },
    },
]

jinja2.py 环境配置 #

from django.contrib.staticfiles.storage import staticfiles_storage
from django.urls import reverse
from crispy_forms.utils import render_crispy_form
import os
from jinja2 import Environment, FileSystemLoader

custom_template_dir = "/workspaces/valapp/valapp/templates"    

def environment(**options):
    env = Environment(**options)
    env.globals.update({
        'static': staticfiles_storage.url,
        'crispy': render_crispy_form,
        'url': reverse,
    })
    env.loader = FileSystemLoader(custom_template_dir)
    return env

requirements.txt #

asgiref==3.6.0
Django==4.1.7
pytz==2022.7.1
sqlparse==0.4.4
crispy-bootstrap4==2022.1
django-crispy-forms==2.0
django-jinja==2.10.2
Jinja2==3.1.2
psycopg2==2.9.5
click==8.1.3
reportlab==3.6.12

Dockerfile #

FROM python:3.10.11-alpine3.17

WORKDIR /app

COPY requirements.txt requirements.txt

RUN apk update

RUN apk add postgresql-dev gcc python3-dev musl-dev

RUN apk add --no-cache freetype-dev

RUN pip3 install -r requirements.txt

COPY . .

CMD ["python3", "manage.py", "runserver", "0.0.0.0:8000"]

核心疑问 #

为何本地/Docker环境中Django默认使用Django模板引擎，而Github Codespaces中能正常调用Jinja2引擎？

1. 修正模板文件命名规则 #

django-jinja默认仅识别.jinja2或.jinja后缀的模板文件，.html文件会优先被Django模板引擎处理：

• 将模板文件后缀改为.jinja2
• 或在Jinja2引擎的OPTIONS中添加后缀匹配配置：

"OPTIONS": {
    "environment": 'valuation.jinja2.environment',
    "match_extension": ".html",
    "extensions": ["django_jinja.builtins.extensions.DjangoFiltersExtension"]
}

2. 修复硬编码的模板路径 #

jinja2.py中custom_template_dir使用了Codespaces专属路径，本地和Docker环境无法匹配，导致Jinja2引擎找不到模板， fallback到Django引擎。修改为动态路径：

from django.conf import settings

# 替换原硬编码路径
custom_template_dir = os.path.join(settings.BASE_DIR, 'valapp', 'templates')

3. 验证模板引擎加载顺序与路径 #

Django按TEMPLATES列表顺序尝试加载模板，若Jinja2引擎无法找到对应模板，会自动使用第二个Django引擎：

• 确认Jinja2引擎的DIRS和APP_DIRS配置正确，能定位到模板文件
• 避免同一模板文件同时存在于两个引擎的搜索路径中

4. 检查Docker环境路径一致性 #

在Dockerfile中添加调试命令，验证容器内模板路径是否正确：

RUN ls -la /app/templates
RUN ls -la /app/valapp/templates

5. 确认环境变量配置 #

检查本地和Docker环境的DJANGO_SETTINGS_MODULE是否指向正确的配置文件，避免加载错误的模板设置。

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