使用SQLAlchemy为MySQL创建自引用表遇TypeError错误求助

算力阿峰

2026-6-14

解决方案

错误原因

你遇到的TypeError是因为mapped_column对参数格式有严格要求：

若你直接写ForeignKey="account.id"，是把ForeignKey当作了关键字参数，但mapped_column不识别该参数名，必须用正确的位置参数或指定关键字参数。
若已实例化ForeignKey("account.id")仍报错，大概率是导入错误——ForeignKey需从sqlalchemy包导入，而非sqlalchemy.orm。

正确写法（SQLAlchemy 2.0+ 推荐）

方法1：传入`ForeignKey`实例作为位置参数

from sqlalchemy import Integer, ForeignKey
from sqlalchemy.orm import mapped_column, DeclarativeBase, relationship

class Base(DeclarativeBase):
    pass

class Account(Base):
    __tablename__ = "account"
    id = mapped_column(Integer, primary_key=True)
    # 注意：ForeignKey是实例化后的对象，且从sqlalchemy导入
    parent_id = mapped_column(Integer, ForeignKey("account.id"))
    # 可选：添加自引用关系
    parent = relationship("Account", remote_side=[id])

方法2：使用`foreign_key`关键字参数（更简洁）

无需实例化ForeignKey对象，直接传入表名+字段名：

from sqlalchemy import Integer
from sqlalchemy.orm import mapped_column, DeclarativeBase, relationship

class Base(DeclarativeBase):
    pass

class Account(Base):
    __tablename__ = "account"
    id = mapped_column(Integer, primary_key=True)
    parent_id = mapped_column(Integer, foreign_key="account.id")

兼容SQLAlchemy 1.x版本的写法

如果项目使用1.x版本，需用Column替代mapped_column，并使用旧版声明式基类：

from sqlalchemy import Column, Integer, ForeignKey
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import relationship

Base = declarative_base()

class Account(Base):
    __tablename__ = "account"
    id = Column(Integer, primary_key=True)
    parent_id = Column(Integer, ForeignKey("account.id"))
    parent = relationship("Account", remote_side=[id])