SQLAlchemy多对多关联ORM类创建报错，请求技术帮助

错误原因 #

1. 中间表定义顺序问题：songs_artists表定义在Song和Artist类之后，ORM初始化时，类中的relationship引用该表时变量尚未定义，导致名称查找失败。
2. 语法错误：Song类中artist字段的relationship语句缺少闭合括号。
3. 关联类型错误：Artist类中song字段的类型应为List['Song']（多对多关联中一个艺术家对应多首歌曲），而非单个Song。

修正后的代码 #

from sqlalchemy import Table, Column, Integer, String, Date, ForeignKey
from sqlalchemy.orm import Mapped, mapped_column, relationship, List
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

# 先定义中间表，确保ORM类可直接引用
songs_artists = Table(
    'songs_artists',
    Base.metadata,
    Column('SONG_ID', Integer, ForeignKey('songs.SONG_ID'), primary_key=True),
    Column('ARTIST_ID', Integer, ForeignKey('artists.ARTIST_ID'), primary_key=True)
)

class Song(Base):
    __tablename__ = 'songs'

    SONG_ID: Mapped[int] = mapped_column(Integer, primary_key=True, nullable=False, index=True)
    ALBUM_ID: Mapped[int] = mapped_column(Integer, ForeignKey('albums.ALBUM_ID'), nullable=False)
    GENRE_ID: Mapped[int] = mapped_column(Integer, ForeignKey('genres.GENRE_ID'), nullable=False)
    FILE_ID: Mapped[int] = mapped_column(Integer, ForeignKey('files.FILE_ID'), nullable=False)
    DURATION: Mapped[int] = mapped_column(Integer)
    TITLE: Mapped[str] = mapped_column(String(100))
    RELEASE_DATE: Mapped[Date] = mapped_column(Date)

    file: Mapped['File'] = relationship(back_populates="song")
    album: Mapped['Album'] = relationship(back_populates="song")
    genre: Mapped['Genre'] = relationship(back_populates="song")
    # 修复语法错误，添加闭合括号；类型声明为List['Artist']匹配多对多关系
    artist: Mapped[List['Artist']] = relationship(secondary=songs_artists, back_populates="song")

class Artist(Base):
    __tablename__ = 'artists'

    ARTIST_ID: Mapped[int] = mapped_column(Integer, primary_key=True)
    ARTIST_NAME: Mapped[str] = mapped_column(String(100))

    # 修正类型为List['Song']，匹配多对多关联逻辑；直接引用已定义的中间表变量
    song: Mapped[List['Song']] = relationship(secondary=songs_artists, back_populates="artist")

关键修改说明 #

• 调整中间表位置：将songs_artists表的定义移至ORM类之前，确保类中的relationship能直接引用该变量，避免名称查找问题。
• 修复语法错误：为Song类中artist字段的relationship语句补充闭合括号。
• 修正关联类型：将Artist类的song字段类型改为Mapped[List['Song']]，符合多对多关联中“一个艺术家对应多首歌曲”的实际映射关系。
• 直接引用中间表变量：secondary参数直接使用已定义的songs_artists变量，而非字符串，提升代码可靠性。

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