# sqlalchemy.exc.ArgumentError: asyncio 扩展需要使用异步驱动程序。'sqlite' 驱动程序不是异步的。

- **ID:** `python/sqlalchemy-missing-async-driver`
- **领域:** python
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

在 SQLAlchemy 的异步扩展中使用了同步数据库驱动，如 sqlite3 或 psycopg2。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 1.4.x | active | — | — |
| 2.0.x | active | — | — |

## 解决方案

1. **** (95% 成功率)
   ```
   Use create_async_engine with an async driver: from sqlalchemy.ext.asyncio import create_async_engine; engine = create_async_engine('postgresql+asyncpg://user:pass@localhost/db')
   ```
2. **** (90% 成功率)
   ```
   For SQLite, use aiosqlite: engine = create_async_engine('sqlite+aiosqlite:///foo.db')
   ```

## 无效尝试

- **** — create_engine doesn't accept an async parameter; you must use create_async_engine. (90% 失败率)
- **** — The driver must be installed separately; otherwise ImportError occurs. (80% 失败率)
