uvicorn 如何启用异步模式

要启用异步模式，您需要使用 uvicorn 的 `--workers` 参数来设置工作进程的数量，并将应用程序对象传递给 `uvicorn.run()` 方法的 `app` 参数。还需要确保您的应用程序使用了异步 I/O，例如使用 `async def` 定义异步视图函数或使用异步库进行数据库访问。

以下是一个示例：

import uvicorn
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}

if __name__ == "__main__":
    uvicorn.run("main:app", host="0.0.0.0", port=8000, workers=4)

在此示例中，我们将工作进程的数量设置为 4，以便能够同时处理多个请求。`main:app` 表示在名为 `main.py` 的文件中，我们将应用程序对象命名为 `app`。您可以将其替换为您自己的文件名和应用程序对象名称。

相关问题

uvicorn 不阻塞线程

### Uvicorn 配置非阻塞线程模式

为了配置 Uvicorn 以实现非阻塞线程模式并支持异步处理，可以利用 `asyncio` 库以及优化的依赖项如 `uvloop` 和 `httptools` 来提升性能。通过这些工具，Uvicorn 能够高效地管理大量并发连接而不阻塞主线程。

#### 安装必要的库
首先安装所需的包来增强 Uvicorn 的能力：

pip install uvicorn[standard] uvloop httptools

这会安装标准版 Uvicorn 及其推荐使用的加速组件[^1]。

#### 启动命令设置
启动应用时可以通过命令行参数指定使用更高效的事件循环策略:

uvicorn main:app --http httptools --loop uvloop

这里指定了 HTTP 解析器为 `httptools` 并启用了更快捷的 UVLoop 替代默认的 asyncio 实现。

#### 编写异步 API 接口
当构建 FastAPI 或其他基于 ASGI (Asynchronous Server Gateway Interface) 的应用程序时，定义路由应尽可能采用真正的异步方式编写，即标记为 async 函数，并且只调用同样是非阻塞性质的操作或服务。对于不可避免要发生的长时间运行任务，则应该将其放入后台进程中去完成而不是直接在请求响应周期内操作[^3]。

from fastapi import FastAPI
import asyncio

app = FastAPI()

@app.get("/")
async def read_root():
    await asyncio.sleep(0)  # 让出控制权给调度程序
    return {"message": "Hello World"}

上述例子展示了如何创建一个简单的异步端点，在其中加入了短暂的休眠以便更好地理解协程的工作原理[^4]。

如果确实存在某些无法绕过的同步代码段（比如数据库查询），则建议把这些部分外包给专门的任务队列或者多进程/线程池来进行隔离处理，从而不影响整个系统的高可用性和快速响应特性[^2]。