Alembic(MySQL)含指定长度列的索引每次迁移重复删建问题求助

方法一：用SQLAlchemy func替代text构造索引 #

直接用func生成带长度限制的索引字段，让SQLAlchemy能识别表达式结构，生成稳定的索引签名，避免Alembic误判。修改模型代码如下：

from sqlalchemy import func

class X( Base ):
    __tablename__   = "X"
    __table_args__  = (
        Index( "index1", "downloaded", func.substr(x_name, 1, 255) ),
    )

    id:         Mapped[ int ]   = mapped_column( BIGINT( unsigned = True ), primary_key = True )
    downloaded: Mapped[ date ]  = mapped_column( DATE )
    x_name:     Mapped[ str ]   = mapped_column( TINYTEXT )

func.substr(x_name, 1, 255)会生成和x_name(255)等效的SQL，同时SQLAlchemy能解析这个表达式的结构，Alembic就能正确识别索引的一致性，不会重复删建。

方法二：自定义Alembic索引差异检测逻辑 #

如果必须保留text写法，可在Alembic的env.py中添加自定义逻辑，拦截重复的索引删建操作：

from alembic.autogenerate import renderers

def compare_indexes(context, inspected, metadata, diffs):
    to_remove = []
    # 遍历所有索引差异
    for diff in diffs:
        # 只针对表X的index1处理
        if diff[0] == "remove" and diff[1].name == "index1" and diff[1].table.name == "X":
            # 查找对应的新增操作
            add_match = next((d for d in diffs if d[0] == "add" and d[1].name == "index1" and d[1].table.name == "X"), None)
            if add_match:
                # 同时移除删、建两个差异操作
                to_remove.append(diff)
                to_remove.append(add_match)
    for d in to_remove:
        diffs.remove(d)

# 注册自定义比较函数
renderers.index_renderer = compare_indexes

这段代码会检测到index1被误标记为删除又新增时，直接把这两个操作从迁移差异列表中移除，避免无用的索引重建。

关于“自定义实现”的说明 #

警告里的“自定义实现”指的是针对你使用的数据库方言（比如MySQL），扩展SQLAlchemy的索引签名生成逻辑，让它能正确解析text("x_name(255)")这类表达式，生成稳定的签名而非近似值。但这种方法需要深入修改SQLAlchemy方言代码，复杂度较高，上面两种方法更适合快速解决问题。

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