在异步环境下使用 aiomysql 执行 CREATE TABLE IF NOT EXISTS 语句失败原因

在异步环境下使用 aiomysql 执行 CREATE TABLE IF NOT EXISTS 语句失败，通常与以下几个因素有关：

1. 事务隔离级别与隐式提交

MySQL 在 DDL 语句（如 CREATE TABLE）执行时会隐式提交当前事务。而 aiomysql 作为异步驱动，默认会开启事务上下文。这种机制可能导致以下问题：

• 事务嵌套冲突：DDL 语句强制提交事务，破坏了异步操作的事务上下文
• 锁等待超时：高并发下，表结构操作可能被其他事务阻塞

2. 错误处理机制不完善

异步环境中，SQL 执行错误可能被异步任务捕获，但未正确传播到上层调用。例如：

async def create_table():
    async with pool.acquire() as conn:
        async with conn.cursor() as cursor:
            try:
                await cursor.execute(create_table_sql)
                await conn.commit()  # 显式提交，但可能已被隐式提交破坏
            except Exception as e:
                print(f"Error: {e}")  # 错误被捕获但未处理

3. 连接池配置问题

aiomysql 的连接池默认配置可能不适合 DDL 操作，例如：

# 创建连接池时未指定合适的参数
pool = await aiomysql.create_pool(
    host='localhost',
    port=3306,
    user='user',
    password='password',
    db='test',
    autocommit=False  # 默认关闭自动提交，可能导致问题
)

解决方案

方案一：使用 autocommit 模式

async def create_table_safe():
    async with pool.acquire() as conn:
        async with conn.cursor() as cursor:
            # 临时开启自动提交模式
            await conn.autocommit(True)
            try:
                await cursor.execute(create_table_sql)
            except Exception as e:
                print(f"Table creation failed: {e}")
            finally:
                # 恢复原设置（如果需要）
                await conn.autocommit(False)

方案二：显式处理事务边界

async def ensure_table_exists():
    async with pool.acquire() as conn:
        async with conn.cursor() as cursor:
            # 检查表格是否已存在
            await cursor.execute("SHOW TABLES LIKE 'car_info'")
            if not await cursor.fetchone():
                try:
                    # 开始事务
                    await conn.begin()
                    await cursor.execute(create_table_sql)
                    await conn.commit()
                except Exception as e:
                    await conn.rollback()
                    raise RuntimeError(f"Table creation failed: {e}")

方案三：使用数据库元数据验证

async def create_table_safe():
    async with pool.acquire() as conn:
        async with conn.cursor() as cursor:
            try:
                await cursor.execute(create_table_sql)
            except aiomysql.Error as e:
                # 忽略表已存在的错误
                if e.args[0] != 1050:  # ER_TABLE_EXISTS_ERROR
                    raise

关键排查步骤

1. 检查 MySQL 错误日志：查看是否有表创建失败的具体原因
2. 验证连接池配置：确保 autocommit 设置符合操作需求
3. 捕获详细错误信息：在异常处理中打印完整的错误堆栈
4. 使用 SHOW CREATE TABLE 验证：检查实际表结构是否与预期一致

通过以上方法，应该能够解决 aiomysql 异步环境下 IF NOT EXISTS 失效的问题。