SQLAlchemy索引命名规则未生效：主键与外键命名不符合预期

核心原因 #

你混淆了SQLAlchemy中**约束（Constraint）和索引（Index）**的区别：

• 命名规则里的pk、fk是针对主键约束、外键约束的命名，不是你通过index=True生成的普通索引。
• id列的primary_key=True会自动创建主键约束（这个约束会遵循pk命名规则），但你额外加的index=True是生成了一个独立的普通索引，只会走ix的命名规则。
• 同理，owner_id的ForeignKey会创建外键约束（遵循fk命名规则），但index=True是额外生成的普通索引，依旧走ix规则。

你可以去数据库里查看约束名称，会发现主键约束确实是pk_items（符合你的pk_%(table_name)s规则），外键约束是fk_items_owner_id_users（符合fk规则），只是你当前查看的是索引的名称，而非约束名称。

解决方案 #

方式1：手动创建索引并指定名称 #

去掉列上的index=True，手动定义Index对象并指定自定义名称：

class Item(Base):
    __tablename__ = "items"

    id = Column(Integer, primary_key=True, nullable=False)
    title = Column(String, index=True)
    description = Column(String, index=True)
    owner_id = Column(Integer, ForeignKey("users.id"))

    # 手动定义自定义名称的索引
    __table_args__ = (
        Index('pk_items_id', 'id'),
        Index('fk_items_owner_id', 'owner_id'),
    )

    owner = relationship("User", back_populates="items")

方式2：通过info参数动态修改索引命名 #

修改ix的命名规则模板，加入自定义前缀占位符：

POSTGRES_INDEXES_NAMING_CONVENTION = {
    "ix": "%(prefix)s_%(table_name)s_%(column_0_name)s",
    "uq": "uq_%(table_name)s_%(column_0_name)s",
    "ck": "ck_%(table_name)s_%(constraint_name)s",
    "fk": "fk_%(table_name)s_%(column_0_name)s_%(referred_table_name)s",
    "pk": "pk_%(table_name)s"
}

然后在列定义时通过info参数传递前缀：

id = Column(Integer, primary_key=True, nullable=False, index=True, info={"prefix": "pk"})
owner_id = Column(Integer, ForeignKey("users.id"), index=True, info={"prefix": "fk"})

重要提示 #

• 主键约束在数据库层面会自动生成唯一索引，你额外加index=True会创建重复索引，完全没必要，建议直接去掉主键列的index=True。
• PostgreSQL不会自动为外键创建索引，若业务查询需要，可保留外键列的索引，但要明确这是独立于外键约束的对象。

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