编程开发 通用 中文 English FastAPI 服务品味 # 一位 Python API 工程师的 FastAPI 服务品味 - 使用 Pydantic v2 模型定义请求体和响应体,并… 生成后的提示词 # 一位 Python API 工程师的 FastAPI 服务品味 - 使用 Pydantic v2 模型定义请求体和响应体,并始终设置 response_model,以免意外泄露任何内容。置信度:0.95 - 为创建、更新和读取保留独立的 schema,而不是复用 ORM 模型作为 API 形状。置信度:0.90 - 仅当内部每个调用都真正异步时,才使用 async def 端点;否则编写普通的 def,让线程池处理它。置信度:0.85 - 通过 Depends 注入数据库会话、设置和当前用户,绝不要通过模块级全局变量注入。置信度:0.90 - 使用 pydantic-settings 从环境变量加载配置,并在启动时若缺少任何内容就快速失败。置信度:0.90 - 按领域将路由拆分到 APIRouter 模块中,并让 main.py 仅限于应用创建和装配。置信度:0.85 - 将业务逻辑放在对 HTTP 一无所知的 service 函数中,以便它们可以从 worker 和测试中复用。置信度:0.85 - 使用 SQLAlchemy 2.0 风格与异步会话,并用 Alembic 迁移管理数据库模式。置信度:0.80 - 使用 lifespan 上下文管理器进行启动和关闭,而不是使用已弃用的 on_event 钩子。置信度:0.85 - 仅在边界处抛出 HTTPException,并通过注册的异常处理器将领域错误映射到状态码。置信度:0.80 - 返回一致的错误响应体,包含机器可读的 code、message 和可选的 details。置信度:0.85 - 在路径中为 API 设置版本(/v1),并将生成的 OpenAPI schema 视为在 CI 中检查的契约。置信度:0.75 - 对大型列表使用基于游标的分页,并在服务器端限制页大小。置信度:0.80 - 使用 pytest 和 httpx.AsyncClient 进行测试,覆盖依赖项而不是修补内部实现。置信度:0.90 - 在生产环境中让 uvicorn worker 运行在 gunicorn 或进程管理器之后,--reload 仅用于开发环境。置信度:0.80 - 将慢任务卸载到真正的任务队列,例如 Celery、Arq 或 Dramatiq;BackgroundTasks 只适用于小型即发即忘任务。置信度:0.85 - 从第一天起就添加请求 ID、结构化 JSON 日志和 OpenTelemetry 追踪中间件。置信度:0.80 - 通过安全依赖项使用 OAuth2 bearer tokens 或 API 密钥保护端点,以便文档展示认证方案。置信度:0.80 - 暴露独立的 /healthz 和 /readyz 端点,其中就绪检查会检查数据库和其他硬依赖项。置信度:0.85 - 使用 uv 和锁文件管理依赖项,并使用 Ruff 进行 lint 和格式化。置信度:0.75 - 在服务包上以严格模式使用 mypy 或 pyright 进行类型检查。置信度:0.70 复制提示词 分享提示词 查看示例 发送到 AI 优化器 收藏模板 保存当前版本 示例 关闭 分享 卡片风格 雾面玻璃 暖白纸笺 深夜蓝图 薄荷网格 珊瑚日落 水墨笺 关闭 图片仅展示节选。