Flask SQLAlchemy+PostgreSQL多列唯一约束被拆分为单列约束如何解决

你的代码写法在语法上是正确的，但PostgreSQL出现将联合约束拆分为单列约束的情况，可通过以下方式排查和修复：

1. 确认SQLAlchemy版本兼容性 #

旧版SQLAlchemy（低于1.3.x）在处理PostgreSQL的UniqueConstraint时可能存在兼容性问题，建议升级到最新稳定版。

2. 改用Index显式创建联合唯一索引 #

如果UniqueConstraint方式仍不生效，可以直接使用Index创建联合唯一索引（PostgreSQL中唯一约束本质就是带有唯一属性的索引，效果完全一致）：

class XYZ(sqla.Model):
    id = sqla.Column(sqla.Integer, primary_key=True, autoincrement=True)
    article_id = sqla.Column(sqla.Integer, sqla.ForeignKey('article.id'))
    story_id = sqla.Column(sqla.Integer, sqla.ForeignKey('story.id'))
    article_position = sqla.Column(sqla.Integer)
    __table_args__ = (
        sqla.Index(
            'unique_article_story_pos', 
            'article_id', 'story_id', 'article_position', 
            unique=True
        ),
    )

3. 清理旧约束并重新迁移 #

如果之前已经生成了错误的单列唯一约束，需要先手动删除这些约束：

-- 假设错误的单列约束名为article_id_key、story_id_key、article_position_key
ALTER TABLE xyz DROP CONSTRAINT article_id_key;
ALTER TABLE xyz DROP CONSTRAINT story_id_key;
ALTER TABLE xyz DROP CONSTRAINT article_position_key;

之后重新执行数据库迁移（如使用Alembic则运行alembic upgrade head），确保新的联合约束/索引正确创建。

验证约束是否生效 #

在PostgreSQL终端执行\d xyz（替换为你的实际表名），查看输出中是否存在如下条目：

"unique_article_story_pos" UNIQUE CONSTRAINT, btree (article_id, story_id, article_position)

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