用 FastAPI 构建微服务网关的核心是将 httpx.AsyncClient 作为转发引擎，通过通配路由 @app.api_route("/{path:path}", methods=["GET","POST","PUT","DELETE","PATCH","HEAD","OPTIONS"]) 捕获全部方法，配合中间件统一管控鉴权、路由与密钥，使下游服务彻底解耦 UPSTREAM_KEY 和 API_BASE_URL。
直接上结论：用 FastAPI 构建微服务网关，核心不是“写个新框架”，而是把 httpx.AsyncClient 当成转发引擎，用通配路由 + 中间件控制流向，再把鉴权、路由表、上游密钥全部收口到网关层——下游服务从此不用碰 UPSTREAM_KEY 或 API_BASE_URL。
怎么写通配路由转发？别用 @app.get 写死方法
常见错误是为每个 HTTP 方法单独写一个 endpoint，比如 @app.post("/user/{path:path}")，结果漏掉 PATCH 或 OPTIONS，前端预检失败就卡住。正确做法是用 @app.api_route("/{path:path}", methods=["GET","POST","PUT","DELETE","PATCH","HEAD","OPTIONS"]) 捕获全部方法。
- 必须显式列出所有方法，
methods=["*"]不合法 -
path: str参数要和Request一起声明，否则拿不到原始 body - 转发前记得清理掉
host、connection、content-length这类代理不应当透传的 header - body 必须用
await request.body()读一次，httpx 不支持重复读取
为什么用 httpx.AsyncClient 而不是 requests？
同步阻塞的 requests 在高并发下会迅速吃光线程池，uvicorn 的异步 event loop 会被拖垮。而 httpx.AsyncClient 复用连接池、支持 HTTP/2、能自然融入 FastAPI 的 async/await 流程。
- 初始化时加
timeout=httpx.Timeout(30.0)，避免后端挂起导致网关线程堆积 - 务必复用单例 client（如模块级全局变量），不要每次请求都
AsyncClient() - 若下游服务返回非 JSON（比如文件流或 HTML），不能直接
return response.json()，得用Response(content=response.content, status_code=response.status_code, headers=dict(response.headers))
路由匹配逻辑容易错在哪？前缀判断不能只靠 str.startswith
比如 ROUTE_TABLE = {"/user": "http://u", "/users": "http://u2"}，当请求 /users/123 时，"/user" 会先匹配成功，导致误转到错误服务。这不是 bug，是设计缺陷。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
- 必须按路径长度倒序排序匹配，优先比对更长前缀
- 推荐用
sorted(ROUTE_TABLE.keys(), key=len, reverse=True)预处理 - 生产环境别用内存 dict 存路由表，应从 Redis 或数据库动态加载，支持热更新
- 路径末尾要不要带
/要统一，比如"/user/"和"/user"匹配逻辑不同，建议全用带尾斜杠形式
密钥和上游地址为什么必须收口到网关？
一旦下游服务（如 user-service）自己调大模型 API，就会出现密钥轮换时漏改、Key 泄露进日志、权限粒度失控等问题。TaoToken 这类统一通道的价值，就是让网关成为唯一出口。
- 网关配置里只保留一份
TAOTOKEN_API_KEY和TAOTOKEN_BASE_URL - 下游服务调用全部走
http://gateway:8000/upstream/llm这类内部路由，不再直连外部 - 转发到 TaoToken 时，
Authorizationheader 由网关拼装，下游无感知 - 这个环节最容易被忽略的是：没校验 TaoToken 返回的
401或429，直接透传给前端，导致错误归因混乱
真正难的不是转发代码，是路由热更新机制、密钥安全注入方式、以及如何让下游服务信任网关转发的 X-Forwarded-For 和用户身份——这些细节不压平，网关迟早变成故障放大器。
