fastapi需用jinja2templates返回html，必须传request且key为"request"；response_class=htmlresponse要显式声明；静态文件须app.mount()挂载并用url_for动态引用。
FastAPI 本身不内置模板引擎，但通过 Jinja2Templates 可以直接返回渲染后的 HTML 页面，关键不是“能不能”，而是 request 必须作为上下文传入、且 context 字典里 "request" 这个 key 不能省略或改名——漏掉它会报 KeyError: 'request'。
必须传 request 参数，且 key 名固定为 "request"
这是最常踩的坑：Jinja2 模板里用 {{ url_for(...) }} 或 {{ request.url.path }} 时，底层依赖 Starlette 的 Request 实例。如果没传、传错名、或放在其他嵌套结构里（比如 {"data": {"request": request}}），TemplateResponse 就会在渲染阶段抛出 KeyError。
-
templates.TemplateResponse("index.html", {"request": request, "name": "Alice"})✅ 正确 -
templates.TemplateResponse("index.html", {"req": request})❌ 报错 -
templates.TemplateResponse("index.html", {"request": request}, context={"name": "Alice"})❌ 参数错位，context不是独立参数
response_class=HTMLResponse 要显式声明
虽然不加也能返回 HTML，但加了之后 FastAPI 文档 UI（Swagger）才能正确识别响应类型，前端调试工具也更易解析。尤其当你混用 JSON 和 HTML 路由时，这个标记能避免浏览器把 HTML 当成纯文本下载。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 加了：
@app.get("/page", response_class=HTMLResponse)→ 文档显示text/html - 不加：文档默认推断为
application/json，即使你返回的是 HTML - 注意：FastAPI 0.108.0+ 版本中，
TemplateResponse的参数顺序已统一为name在前、context在后；旧版本可能要求request放在context里
静态文件路径要 app.mount()，且模板里用 url_for 引用
JS/CSS 图片等资源不会自动暴露，必须手动挂载 StaticFiles。模板中也不能写死 /static/style.css，得靠 url_for("static", path="style.css") 动态生成路径——否则部署到子路径（如 /myapp/）时所有静态资源 404。
- 挂载代码：
app.mount("/static", StaticFiles(directory="static"), name="static") - 模板写法：
<link rel="stylesheet" href="%7B%7B%20url_for('static',%20path='/style.css')%20%7D%7D"> - 目录结构必须匹配：
static/文件夹和templates/平级，不能嵌套在app/下却还用directory="app/templates"却忘了调整挂载路径
真正容易被忽略的是 url_for 的 name 参数必须和 app.mount(..., name="xxx") 里的字符串完全一致，大小写敏感，拼错一个字母就 404，而且错误不报在服务端，只体现为浏览器控制台资源加载失败。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
