Langflow 系列 | 第 10 篇：FastAPI 应用入口、生命周期与路由体系解析

摘要

第 9 篇文章从整体架构层梳理了 Langflow 后端的 API、服务层与数据库模型。本篇进一步收窄范围，专门解析后端应用入口：

src/backend/base/langflow/main.py src/backend/base/langflow/api/router.py

这两个文件决定了一个请求在进入具体业务路由之前，会先经历哪些系统级处理：

• FastAPI 应用如何创建。
• Settings 和 Services 如何初始化。
• Startup 阶段做了哪些准备工作。
• Shutdown 阶段如何清理资源。
• 中间件按什么顺序处理请求。
• v1 / v2 路由如何挂载。
• 健康检查、日志接口和静态前端如何接入。
• 异常处理和可观测性如何接入。

如果说第 9 篇是“后端地图”，那本文就是“后端入口的放大图”。理解它之后，阅读任意一个 API 路由时，都能知道它运行在哪个应用上下文里。

读者预期

读完本文后，读者应该能够回答以下问题：

• setup_app()、create_app()、get_lifespan()分别负责什么。
• Langflow 启动时为什么