如何为MySQL现有表添加UUID列并生成唯一随机值（SQLAlchemy）

问题核心 #

你遇到的问题是：Alembic自动生成的升级脚本仅添加了允许为null的UUID列，但没有为现有行填充值，导致后续设置nullable=False和唯一约束时出错。Python端的default=uuid.uuid4是应用层默认值，不会作用于已存在的数据库行。

以下是两种可行的解决方案，分别对应BINARY(16)和String类型：

方案一：使用BINARY(16)类型（空间更高效） #

1. 调整模型定义 #

将default改为生成二进制格式的UUID，和数据库端生成的格式保持一致：

import uuid
from sqlalchemy import BINARY

class MyTable(db.Model):
    uid = db.Column(BINARY(16), nullable=False, unique=True, default=lambda: uuid.uuid4().bytes)

2. 修改Alembic升级脚本 #

替换自动生成的upgrade函数，分三步完成列添加、数据填充和约束设置：

from sqlalchemy import text

def upgrade():
    # 1. 先添加允许为null的列
    op.add_column('my_table', sa.Column('uid', sa.BINARY(length=16), nullable=True))
    
    # 2. 为现有行生成唯一二进制UUID
    # MySQL的UUID()返回带短横线的字符串，用REPLACE去掉后转二进制
    op.execute(text("UPDATE my_table SET uid = UNHEX(REPLACE(UUID(), '-', '')) WHERE uid IS NULL"))
    
    # 3. 修改列为不可null，并添加显式命名的唯一约束
    op.alter_column('my_table', 'uid', nullable=False)
    op.create_unique_constraint('uq_my_table_uid', 'my_table', ['uid'])

def downgrade():
    op.drop_constraint('uq_my_table_uid', 'my_table', type_='unique')
    op.drop_column('my_table', 'uid')

方案二：使用String类型（更直观，便于调试） #

1. 调整模型定义 #

直接生成字符串格式的UUID：

import uuid

class MyTable(db.Model):
    uid = db.Column(sa.String(36), nullable=False, unique=True, default=lambda: str(uuid.uuid4()))

2. 修改Alembic升级脚本 #

同样分三步处理，用MySQL原生的UUID()函数填充数据：

from sqlalchemy import text

def upgrade():
    # 1. 添加允许为null的列
    op.add_column('my_table', sa.Column('uid', sa.String(36), nullable=True))
    
    # 2. 为现有行填充字符串格式UUID
    op.execute(text("UPDATE my_table SET uid = UUID() WHERE uid IS NULL"))
    
    # 3. 修改列属性并添加唯一约束
    op.alter_column('my_table', 'uid', nullable=False)
    op.create_unique_constraint('uq_my_table_uid', 'my_table', ['uid'])

def downgrade():
    op.drop_constraint('uq_my_table_uid', 'my_table', type_='unique')
    op.drop_column('my_table', 'uid')

关键注意点 #

• 不要依赖server_default：MySQL没有内置的二进制UUID生成函数；即使是String类型，server_default=text('UUID()')也只会作用于新插入的行，无法填充已有数据。
• 显式命名唯一约束：避免用None自动生成约束名，这样在降级脚本中能精准操作。
• 填充数据时加WHERE uid IS NULL：防止后续执行升级脚本时重复覆盖已有值（如果脚本多次运行）。

内容的提问来源于stack exchange，提问作者Robert