aiomysql：异步场景下的 MySQL 驱动

文章目录

[aiomysql：异步场景下的 MySQL 驱动](#aiomysql：异步场景下的 MySQL 驱动)
- [核心思路：把 PyMySQL 变异步](#核心思路：把 PyMySQL 变异步)
- 基本用法
- 适用场景
- 需要注意的地方

aiomysql：异步场景下的 MySQL 驱动

Python 异步编程越来越普及，但数据库驱动这一环常常跟不上。aiomysql 就是来解决这个问题的。它是 aio-libs 组织维护的项目，目前获得 1,888 个 Star，目标很明确：让你在 asyncio 环境里也能操作 MySQL。

核心思路：把 PyMySQL 变异步

aiomysql 的底层实现很直接。它本质上是 PyMySQL 的一个异步版本，把底层的 IO 调用换成了异步，加上 async/await 语法。API 层面和 PyMySQL 几乎一致，用过的人基本零成本切换。

SQLAlchemy 支持也从 aiopg 移植了过来。如果你在用 SQLAlchemy 做 ORM，可以比较平滑地迁移到异步模式。

基本用法

用法和 PyMySQL 几乎一样，只是把同步调用改成了异步：

python 复制代码

import asyncio
import aiomysql

async def test_example():
    async with aiomysql.create_pool(
        host='127.0.0.1', port=3306,
        user='root', password='',
        db='mysql'
    ) as pool:
        async with pool.acquire() as conn:
            async with conn.cursor() as cur:
                await cur.execute("SELECT 42;")
                (r,) = await cur.fetchone()
                print(r)

asyncio.run(test_example())

连接池、游标、execute、fetchone，这些概念和 PyMySQL 完全一致。属性访问方式也没有变化。

SQLAlchemy 集成的写法也很接近：

python 复制代码

from aiomysql.sa import create_engine

engine = await create_engine(
    user='root', db='test_pymysql',
    host='127.0.0.1', password=''
)
async with engine.acquire() as conn:
    await conn.execute(tbl.select())
engine.close()
await engine.wait_closed()

适用场景

aiomysql 适合已经基于 asyncio 构建的应用。Web 框架如 FastAPI、Sanic 都深度依赖异步 IO，同步的 MySQL 驱动会成为瓶颈。换成 aiomysql 后，数据库查询不再阻塞事件循环。

已有 PyMySQL 代码库的迁移成本很低。把 conn.execute() 改成 await conn.execute() 就能跑起来。连接池的 async with 模式也符合现代 Python 的惯用写法。

需要注意的地方

项目要求 Python 3.9 以上。这是一个纯 Python 库，没有 C 扩展，性能上比起一些原生异步驱动可能略有差距。但它的优势在于稳定性和兼容性，PyMySQL 的代码底子很扎实。

项目目前处于维护状态，新功能开发不多，但核心功能已经成熟。对于生产环境中的异步 MySQL 需求，它是一个可靠的选择。

如果你正在构建异步 Python 应用，需要一个稳定、熟悉的 MySQL 驱动，aiomysql 值得一试。

3962728)]

如果你正在构建异步 Python 应用，需要一个稳定、熟悉的 MySQL 驱动，aiomysql 值得一试。