刘宏缔的架构森林

2026年6月25日

fastapi:fastapi项目的线上部署，gunicorn和supervisor分别起了什么作用？

摘要：在生产环境中，不建议直接运行 uvicorn main:app，因为一旦程序崩溃不会自动重启，且无法利用多核 CPU。所以我们使用 Gunicorn 来管理 Uvicorn。在 FastAPI 项目的线上部署中，Gunicorn 和 Supervisor 扮演着完全不同的角色，它们的分工极其明确。阅读全文

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

fastapi: 用alembic实现数据库迁移

摘要：一，安装用到的第三方库，并初始化 $ pip install alembic 初始化，注意指定异步模板： alembic init -t async alembic 因为我们使用的是异步驱动（aiomysql），初始化时必须指定 async 异步模板：执行后，项目根目录下会多出 alembic.in 阅读全文

posted @ 2026-06-25 16:28 刘宏缔的架构森林阅读(18) 评论(0) 推荐(0)

fastapi:alembic: alembic revision --autogenerate 命令执行后没有找到数据表？

摘要：一，问题和原因 alembic revision --autogenerate -m "create user table" 这个命令执行后没有效果，没有找到数据表，原因是？ Alembic 的核心配置文件是 migrations/env.py（或 alembic/env.py）。你需要确保在这里显阅读全文

posted @ 2026-06-25 16:19 刘宏缔的架构森林阅读(25) 评论(0) 推荐(0)

2026年6月24日

fastapi: Alembic和flask db 的对应关系

摘要：一， Alembic和flask db的关系 FastAPI 本身并没有默认的数据库迁移库，因为它是一个微框架（Microframework），不绑定任何特定的 ORM 或数据库工具。但在实际开发中，FastAPI 社区官方推荐且最广泛使用的数据库迁移库是 Alembic。它与 flask db（阅读全文

posted @ 2026-06-24 22:30 刘宏缔的架构森林阅读(27) 评论(0) 推荐(0)

fastapi: 同样是post方法提交数据，postman软件params标签下输入键值对和body标签下的form-data有什么区别？fastapi接收参数时的区别？

摘要：一、 Postman 中两种提交方式的本质区别 1. Params（查询参数 / Query Parameters）传输位置：拼接在 URL 链接后面。例如你在 Params 输入 id=10，Postman 实际发出的请求 URL 会变成：http://api.com。数据限制：只能传输纯文阅读全文

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

fastapi: Pydantic v2默认包含的参数校验规则

摘要：一，官方文档地址: https://pydantic.dev/docs/validation/latest/api/pydantic/fields/ 安装用到的库：校验邮箱时用到 $ pip install 'pydantic[email]' 二，代码的例子： # 1. 定义校验规则 # ^[\u4 阅读全文

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

fastapi: 自定义参数校验逻辑

摘要：一，代码： 1,自定义参数校验单码：单字段校验和多字段校验 # 1. 定义请求体数据模型 class UserRegister(BaseModel): username: str = Field(..., min_length=3, max_length=20, description="用户名长度阅读全文

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

fastapi: 有父应用和子应用时，lifespan应该写在哪里？

摘要：一，问题我的项目中有一个父应用两个子应用，lifespan加在子应用上，但代码未被执行，应该怎么做？二，原因：在 FastAPI 中，如果你使用了子应用（Sub-apps）（即通过 app.mount("/sub", sub_app) 挂载），子应用自带的 lifespan 默认是不会被自动触阅读全文

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

fastapi: 实现单文件上传和多文件上传

摘要：一，安装所需的库 $ pip install python-multipart 二，代码： # app/api/v1/asset.py from fastapi import APIRouter, Depends, UploadFile, File from starlette.requests i 阅读全文

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

2026年6月21日

fastapi: 参数校验时自定义报错信息（get/post/json/基于basemodel类/基于Annotated参数）

摘要：一，代码：异常处理 # 2. 捕获 FastAPI 参数校验异常 (422 Unprocessable Entity) @app.exception_handler(RequestValidationError) async def validation_exception_handler(req 阅读全文

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

公告