FastAPI中如何正确引用/继承Jinja2基础模板？

核心错误分析 #

1. 错误挂载模板目录：你用app.mount挂载了Jinja2Templates，但mount是用来挂载静态文件（如CSS、JS）的，模板由Jinja2引擎直接加载，不需要这一步操作。
2. 模板继承语法错误：在extends中错误使用了{{ url_for('templates', path='/base.html') }}，Jinja2会把整个字符串当作模板文件名去查找，自然找不到对应的文件。模板继承只需要直接写模板文件名即可，因为引擎已经知道模板根目录的位置。

正确修改步骤 #

1. 修正main.py配置

删除挂载templates的代码行，保留静态文件挂载即可：

app = FastAPI()
app.add_middleware(GZipMiddleware, minimum_size=500)
app.include_router(default.router)
#app.include_router(data_mgr_view.router)

# 仅保留静态文件挂载
app.mount("/static", StaticFiles(directory="static"), name="static")
# 移除这行错误代码：app.mount("/templates", Jinja2Templates(directory="templates"), name="templates")

2. 确保Jinja2Templates实例初始化正确

在alpha_insite/config.py中正确初始化模板引擎：

from fastapi.templating import Jinja2Templates

# 指定模板根目录为项目下的templates文件夹
tmplts = Jinja2Templates(directory="templates")

3. 修正模板文件代码

将index.html改回和Flask一致的写法：

{% extends "base.html" %} {% block title %}Home{% endblock %}

验证目录结构 #

确保你的项目目录结构如下：

项目根目录/
├── main.py
├── static/
├── templates/
│   ├── base.html
│   └── index.html
└── alpha_insite/
    └── config.py

这样修改后，访问根路径时Jinja2就能正确找到base.html并完成模板继承渲染。

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