无法创建SQLAlchemy唯一索引报错，请求排查代码问题

你的代码问题出在__table_args__的格式定义上，这也是导致唯一索引创建报错的核心原因。

具体问题点 #

你当前的__table_args__写法：

__table_args__ = {'sqlite_autoincrement': True}, (Index('unique-example', col1, col2, unique=True))

这实际上生成了一个二元组，其中第二个元素又是一个嵌套的元组（包含Index对象）。但SQLAlchemy对__table_args__的格式有明确要求：如果需要同时指定表选项（比如sqlite_autoincrement）和索引/约束，必须将所有元素直接放在同一个顶层元组中，不能嵌套元组。

这种嵌套结构会让SQLAlchemy无法正确识别索引定义，进而触发报错。

修正后的代码 #

把表选项字典和Index对象直接放在同一个元组里即可，修正后的完整类定义如下：

class ExampleClass(Base):
    __tablename__ = 'example'
    __table_args__ = (
        {'sqlite_autoincrement': True},
        Index('unique-example', 'col1', 'col2', unique=True)
    )
    index = Column(Integer, primary_key=True, nullable=False)
    col1 = Column(Integer, nullable=True)
    col2 = Column(String, nullable=True)
    col3 = Column(String, nullable=True)

补充说明 #

• 这里用字符串'col1'、'col2'指定列名是更稳妥的方式，因为在__table_args__被解析时，类的属性可能还未完全初始化，直接用字符串可以避免潜在的引用问题。
• 如果__table_args__只包含单个元素（比如仅表选项字典），可以不用元组包裹；但多个元素时，必须用顶层元组统一包裹，每个元素用逗号分隔。

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