使用FastAPI与Jinja2创建动态HTML页面遇500内部错误求助

错误原因分析 #

你的代码存在两个关键问题，直接导致了500内部错误：

• Request对象传递错误：在TemplateResponse的上下文参数中，你传入了Request类而非函数参数里的request实例。Jinja2渲染模板需要当前请求的实例，传递类会引发内部逻辑错误。
• 模板路径问题：使用绝对路径/htmlfiles大概率会导致程序找不到模板文件，除非你确实在系统根目录下创建了该文件夹，建议改用相对路径。

修正后的代码 #

Python代码 #

from fastapi import FastAPI, Request
from fastapi.responses import HTMLResponse
from fastapi.templating import Jinja2Templates

app = FastAPI()

# 使用相对路径，确保当前项目目录下存在htmlfiles文件夹
templates = Jinja2Templates(directory="./htmlfiles")

@app.get("/home/{name}", response_class=HTMLResponse)
def read_item(request: Request, name: str):
    # 传递request实例而非Request类
    return templates.TemplateResponse("test.html", {"request": request, "name": name})

HTML代码（无需修改） #

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Document</title>
  </head>
  <body>
    <h1>hello this is a test page</h1>
    <p>welcome ... {{name}}</p>
  </body>
</html>

验证步骤 #

1. 确认项目目录结构正确：

   项目根目录/
   ├── main.py（你的Python代码文件）
   └── htmlfiles/
       └── test.html
   

2. 启动服务：uvicorn main:app --reload
3. 访问测试路径，比如http://localhost:8000/home/Alice，页面应正常显示动态内容。

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