刘宏缔的架构森林

2026年7月25日

摘要：一，代码：从 Pydantic v2 开始，官方引入了 @computed_field 装饰器，它会自动将一个 Python property 包含在序列化输出（model_dump() / JSON 响应）中，并能被 FastAPI 的 Swagger UI 完美捕获生成文档。 # 输出给前端的阅读全文

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

fastapi: 一个类下包含的model有可能是多种类型j时输出docs文档

摘要：一，代码：说明：当接口参数ctype为0时,items中列表元素是user当接口参数ctype为1时,items中列表元素是asset # 1. 定义列表 WTForms 表单 # 1. 定义请求体数据模型 class UserListForm(BaseModel): page: int = 阅读全文

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

2026年7月24日

fastapi: docs返回数据同一个节点下有多种model时，直接指定数据类型

摘要：一，代码 # 输出给前端的用户信息（安全公开，不含密码，包含只读字段） class UserResponse(BaseModel): id: int = Field(..., description="用户的唯一ID") username: str = Field(..., description= 阅读全文

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

fastapi: 封装接口的数据返回格式，支持文档显示数据格式

摘要：一，代码：返回数据用的泛型封装类: # app/core/BaseResponse.py from typing import Annotated, List, TypeVar, Generic, Optional from pydantic import BaseModel # 1. 定义一个泛阅读全文

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

fastapi: docs用response_model添加输出数据文档

摘要：一，代码 BaseResponse.py: 通用的返回结构,以及T泛型变量的定义 # app/core/BaseResponse.py from typing import Annotated, List, TypeVar, Generic, Optional from pydantic impor 阅读全文

posted @ 2026-07-24 20:56 刘宏缔的架构森林阅读(8) 评论(0) 推荐(0)

fastapi: 接口返回字典和返回JSONResponse的区别

摘要：一，返回字典和返回JSONResponse区别：这是 FastAPI 底层的一个核心设计机制。简单来说：当直接返回字典时，FastAPI 会帮你做“序列化加过滤”的脏活；而当你使用 JSONResponse() 时，你等于绕过了 FastAPI 的安全代理，强行把一个包含数据库 ORM 对象的原阅读全文

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

fastapi: sqlalchemy:分页时得到结果集总数的两种方式

摘要：一，代码：在 FastAPI + 异步 SQLAlchemy 的架构中，获取分页总数据量（Total Count）通常有两种主流高效的方法。方法一：针对mysql5.7及更旧版本：使用 func.count() 进行二次查询（最传统、清晰）这是最稳妥的办法。先构造基础的 select 语句，然后阅读全文

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

2026年7月23日

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

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

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

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

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

posted @ 2026-07-23 18:48 刘宏缔的架构森林阅读(4) 评论(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 刘宏缔的架构森林阅读(9) 评论(0) 推荐(0)

公告