aiomysql.connect() 返回协程对象，必须 await 才获得 Connection；常见错误是未 await 导致 AttributeError；所有操作如 create_pool、acquire、execute 等均需 await，且函数须为 async def。
aiomysql.connect() 为什么不能直接 await？
因为 aiomysql.connect() 返回的是一个协程对象，不是连接实例；直接 await 它才能拿到真正的 Pool 或 Connection。常见错误是写成 conn = aiomysql.connect(...) 然后直接调用 conn.execute()，结果报 AttributeError: 'coroutine' object has no attribute 'execute'。
正确做法是确保整个链路都是 async/await：
- 用
await aiomysql.create_pool()初始化连接池（推荐），或await aiomysql.connect()单次连接 - 所有查询必须在
async with conn.cursor() as cur:或await cur.execute()中进行 - 主线程不阻塞的前提是：你没在同步函数里调用这些异步方法，也没用
loop.run_until_complete()在非事件循环上下文中硬等
如何避免忘记 await 导致的“看似正常实则同步”陷阱？
最典型的伪异步写法：pool.acquire() 没加 await，返回的是 coroutine 对象，但 Python 不会立刻报错——直到你拿它当连接用，才在 execute() 时报 TypeError: object XXX can't be used in 'await' expression 或更隐蔽的 RuntimeWarning: coroutine 'XXX' was never awaited。
关键检查点：
立即学习“Python免费学习笔记（深入）”；
-
create_pool、acquire、execute、fetchall、close—— 全部要await - 别在
def函数里调用它们，必须用async def - 用
asyncio.run(main())启动，别用main()直接调
示例片段：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
async def query_user(user_id):
async with pool.acquire() as conn:
async with conn.cursor() as cur:
await cur.execute("SELECT name FROM users WHERE id = %s", (user_id,))
result = await cur.fetchone()
return result
aiomysql 连接池配置哪些参数影响并发表现？
默认的 minsize=1 和 maxsize=10 在高并发下容易成为瓶颈；连接不够用时请求会排队等待，看起来像“卡住”，实际是协程在等空闲连接，不是数据库慢。
需根据实际负载调整：
-
minsize：预热连接数，设为5~10可减少首次查询延迟 -
maxsize：最大并发连接数，建议 ≤ 数据库服务端的max_connections，留余量防雪崩 -
pool_recycle：设为3600（1小时）可避免 MySQL 的wait_timeout导致的 “Lost connection” 错误 -
echo=True仅调试用，开启后日志会严重拖慢性能
为什么用了 aiomysql 还是感觉“没快多少”？
异步不是银弹。如果业务逻辑本身是 CPU 密集型（比如解析大 JSON、做复杂计算），或者混用了同步 IO（如读本地文件、调用 requests.get()），那 event loop 依然会被阻塞，aiomysql 的连接就空转等着。
典型干扰项：
- 在异步函数里调
time.sleep(1)—— 必须换await asyncio.sleep(1) - 用
pandas.read_sql()—— 它是同步的，得换成await cur.fetchall()+ 手动构 DataFrame - ORM 层没适配异步（如 SQLAlchemy 2.0 以前的
session.execute()是同步的），盲目套壳没用
真正释放异步红利的场景：多个 DB 查询 + 多个 HTTP 请求 + 文件 IO，全部并行发起，而不是串行等一个做完再下一个。
复杂点在于：你要清楚哪部分是真异步、哪部分只是“名字带 async”。一旦某个环节掉链子，整条链就退化成同步执行。
