小叙：FastAPI 是啥玩意儿？

先说实话，FastAPI 就是那个让你写 API 像写普通函数一样顺手的框架。

别kan名字里有个 “Fast”，它的速度真的是快到飞起，背后靠 Starlette + Uvicorn 的异步狂热。

我跟你讲，这玩意儿Zui核心的语法其实就两行：from fastapi import FastAPI 然后 app = FastAPI。

哈哈，这俩字一写，你就Yi经把整个服务给搭起来了。

FastAPI 用装饰器来声明路由，Zui常见的是 @app.get, @app.post, @app.put, @app.delete。

比如：

from fastapi import FastAPI
app = FastAPI
@app.get
async def say_hello:
    return {"msg": "Hello, FastAPI!"}

这段代码干了三件事：

创建了一个 FastAPI 实例。

用 @app.get 装饰器把路径 /hello 绑定到函数。

函数是 async，返回值会自动序列化成 JSON。

FastAPI Zui牛逼的地方，就是它会根据函数参数的类型注解帮你解析请求。

路径参数直接写在 URL 里用大括号 {} 包住：

@app.get
async def read_item:
    return {"item_id": item_id, "q": q}

这里 item_id 必须是 int，q 是可选的查询字符串。FastAPI 会自动把字符串转成 int，要是转不成功就会抛 422 错误。

想要接收 JSON 请求体？直接写一个 Pydantic 模型，然后把它当作函数参数即可。

from pydantic import BaseModel
class UserCreate:
    name: str
    age: int
    email: str | None = None
@app.post
async def create_user:
    # 这里Yi经经过校验啦
    return user

模型字段Ke以加各种校验，比如 Field，FastAPI 会把错误信息直接返回给前端，省去你自己写验证逻辑的麻烦。

依赖注入在 FastAPI 里是通过 Depends 实现的。比如统一获取当前登录用户：

from fastapi import Depends, Header, HTTPException
def get_current_user):
    if not authorization:
        raise HTTPException
    # 假设这里Zuo token 校验...
    return {"user_id": 123, "name": "Alice"}
@app.get
async def profile):
    return current_user

只要在路由函数里加上 Depends, 那么每次请求dou会先跑一次这个依赖函数，把结果传进去。超级方便！

默认情况下FastAPI 把抛出的 自动转换成 JSON 响应。Ru果你想自定义全局异常格式，Ke以写一个异常处理器：

from fastapi import Request
from fastapi.responses import JSONResponse
class BusinessError:
    def __init__:
        self.message = message
@app.exception_handler
async def business_error_handler:
    return JSONResponse(
        status_code=400,
        content={"error": "BUSINESS_ERROR", "msg": exc.message},
    )

为什么百度不收录我的 FastAPI 文档页面？

说实话，这往往跟两点有关：

Crawler 无法访问：Crawl 时Ru果你的服务器只对内网开放或要求 HTTPS 且证书不可信，百度爬虫会直接放弃抓取。解决办法就是确保外网可达，并且使用有效的 SSL 证书。

Sitemap / robots.txt 配置错误：Sitemap 没有列出 /docs 或者 robots.txt 把 /docs 拦截了。记得在根目录放一个合适的 robots.txt，或者在 sitemap 中显式声明 API 文档地址。

Aha，这两个坑踩了以后大多数时候就Nengkan到百度慢慢收录了。不过呢，搜索引擎本身对 API 文档兴趣不大，Ru果你真的想让它们收录，那就把文档页面Zuo成普通网页，多加点文字描述、meta 信息，让爬虫觉得这是“内容”。咱就是说这事儿也不是一蹴而就，需要耐心等几天～你懂的。

Create app: a = FastAPI

Add GET route: @a.get async def fn

Add POST route: @a.post async def fn

Path param: {item_id} + item_id: int

Query param: ?page=1&size=10 → page: int = QueryPydantic model: Hello response model: Error raise: # 同步 vs 异步：到底该选哪个？

Aha，你可Neng听说过“所有接口dou要 async”。其实不然——Ru果你的业务代码里dou是 CPU 密集型或阻塞 IO，直接用 sync 函数geng省心；只有在需要并发等待网络、文件、数据库等 I/O 时才用 async/await 才Neng发挥优势。

"Optional" 表示Ke以传 None，但是Ru果你不给默认值，它仍然是必传的。要让它变成可选，需要写成 x: int | None = None.

pip install "fastapi" uvicorn

uvicorn main:app --reload