一、先看问题：

HTML网页和路由都写好之后，本来以为通过浏览器能正常访问，结果迎面一个“Internal Server Error”，页面干干净净一片空白，什么提示都没有。

二、解决问题

为了看到更详细的错误信息，最简单的方法是在FastAPI实例里加上debug=True这一句。

app = FastAPI(title="智能语音AI袋里", description="提供预约管理、智能咨询、用户行为分析等功能的API服务", version="1.0.0", docs_url="/docs", redoc_url="/redoc", debug=True)

加了debug之后，浏览器终于把具体报错信息吐出来了，如下图所示：

定位问题根源

折腾了一番，发现罪魁祸首是Starlette版本——当时用的是1.3.1。

而Jinja2Templates的TemplateResponse返回值写法变了。

问题就出在Web路由这里：

@router.get("/test_knowledge_management", response_class=HTMLResponse, summary="知识库测试界面")
async def knowledge_test_page1(request: Request):
    """知识库测试界面"""
    return templates.TemplateResponse("test_knowledge_management.html", {"request": request})

新旧版本写法差异

老版本这样写是没问题的：直接用templates.TemplateResponse("test_knowledge_management.html", {"request": request})。

但新版本里TemplateResponse的第一个参数必须是request。

把参数顺序调一下就能正常访问了：

@router.get("/test_knowledge_management", response_class=HTMLResponse, summary="知识库测试界面")
async def knowledge_test_page1(request: Request):
    """知识库测试界面"""
    return templates.TemplateResponse(request, "test_knowledge_management.html", {"request": request})

三、关于AI工具使用的感想

整个过程全程靠AI助手帮忙分析原因，说句实在话，确实好用，能省下不少时间和精力。但在使用过程中也发现了一些门道：

• AI分析的准确性跟你提供的问题描述以及数据的完整度关系很大——怎么把事情说清楚，直接决定了能不能快速定位到问题根因。prompt，还是得好好琢磨。
• AI分析问题其实有挺明显的局限性：它只能基于你当前丢给它的那一段内容去推理，对整个项目的架构、上下文一无所知，没法结合实际情况去判断，有时候给出来的结论并不太靠谱。

《夸克》非常好用的免费AI浏览器

下载APP查看