刘宏缔的架构森林

2026年7月23日

fastapi: 存在httpbasic验证时Json返回需要增加headers

摘要：一，例子当你在 FastAPI 中触发一个 401 异常时，浏览器到底要不要弹出登录框，只取决于响应头（Headers）里有没有 WWW-Authenticate 字段，而跟响应体（Body）是 JSON、纯文本还是 HTML 页面没有任何关系。代码： # 状况 A：如果是 API 子应用的请求阅读全文

posted @ 2026-07-23 22:26 刘宏缔的架构森林阅读(3) 评论(0) 推荐(0)

fastapi: 多个子应用时判断全局异常的处理形式

摘要：一，代码场景： fastapi项目下面有两个子应用，一个是api: 接口站，另一个是admin:管理后台，api接口站，处理异常后返回json，admin.管理后台，有传统的页面请求也有ajax方式访问，要求非ajax时，返回到一个错误信息页面，ajax访问时，当然是返回json 代码： # 返回阅读全文

posted @ 2026-07-23 18:48 刘宏缔的架构森林阅读(1) 评论(0) 推荐(0)

fastapi: 用ipython从命令行执行项目中的函数

摘要：一，安装第三方库: $ pip install ipython 二，执行一个同步方法：执行ipython启动界面 In [1]: from app.utils.file_handle import get_file_info In [2]: get_file_info('/data/file/fa 阅读全文

posted @ 2026-07-23 15:00 刘宏缔的架构森林阅读(1) 评论(0) 推荐(0)

fastapi: 用lifespan在应用启动时初始化数据（数据播种）

摘要：一，代码 # 初始化必需的数据：添加一个管理员账号 async def init_data(): """执行具体的异步数据逻辑""" async with AsyncSessionLocal() as db: async with db.begin(): # 开启事务 # 使用 2.0 的 sele 阅读全文

posted @ 2026-07-23 14:38 刘宏缔的架构森林阅读(1) 评论(0) 推荐(0)

fastapi: 在正式站直接关闭docs文档

摘要：一，代码 .env # 当前环境，开发，development, 测试，testing,正式: production ENV="production" main.py ENV = settings.ENV print("ENV:", ENV) IS_DEV = ENV == "development 阅读全文

posted @ 2026-07-23 12:16 刘宏缔的架构森林阅读(2) 评论(0) 推荐(0)

2026年7月22日

fastapi: 给docs文档添加用户名密码验证

摘要：一，代码: 说明：如果生产环境中确实需要让外部客户或内部运营人员查看文档，但又不能公开，加上“用户名/密码”是最轻量高效的方案。FastAPI 本身并没有给 /docs 内置开关，但我们可以通过关闭默认路由，改为手动重写 docs 接口并注入安全依赖来实现。效果：任何人访问 /docs 时，浏阅读全文

posted @ 2026-07-22 22:43 刘宏缔的架构森林阅读(3) 评论(0) 推荐(0)

fastapi: 解决docs文档打开swaggerui时速度慢

摘要：一，原因 FastAPI 默认从国外的公共 CDN（如 cdn.jsdelivr.net）动态加载 Swagger 的 CSS 和 JS 静态资源文件。在国内或特定的生产局域网环境下，由于网络阻断或延迟，就会导致页面卡死或加载长达十几秒。在生产环境中，最标准且最彻底的解决办法就是把这些 CDN 文阅读全文

posted @ 2026-07-22 17:35 刘宏缔的架构森林阅读(0) 评论(0) 推荐(0)

fastapi: 在路由函数中判断请求方法（使get/post方法使用同一个函数）

摘要：一，代码： # GET POST 路由：处理表单提交 @router.api_route("/register", methods=["GET", "POST"], summary="用户注册") async def post_register(request: Request,db: AsyncS 阅读全文

posted @ 2026-07-22 16:29 刘宏缔的架构森林阅读(2) 评论(0) 推荐(0)

fastapi: 列出所有include_router所包含的router以及每个router下的路由

摘要：一，代码：说明: router要加上tag做说明 endpoint要加上summary做说明 @router.get("/allroutes", summary="路由列表") def get_routers_and_routes(request: Request): current_app = 阅读全文

posted @ 2026-07-22 16:10 刘宏缔的架构森林阅读(0) 评论(0) 推荐(0)

fastapi: 列出所有路由endpoint

摘要：一，代码：在 FastAPI 中，获取所有接口的 endpoint 非常简单。FastAPI 实例（通常是 app）内部维护了一个 routes 列表，里面包含了所有注册的路由信息。我们可以通过遍历 app.routes 来提取每个接口的 URL 路径、HTTP 方法（GET/POST等）以及阅读全文

posted @ 2026-07-22 15:44 刘宏缔的架构森林阅读(2) 评论(0) 推荐(0)

公告