使用SQLAlchemy association_proxy触发default_factory错误求助

问题背景 #

使用Flask-SQLAlchemy结合Python dataclasses开发应用，基础框架已搭建。此前用纯关联表实现多对多关系正常，现在中间表manys新增字段x，尝试用association_proxy访问该字段时触发报错。

基础配置（init.py） #

from flask import Flask, request, jsonify
from flask_cors import CORS
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config["SQLALCHEMY_DATABASE_URI"] = "postgresql://log:pass@localhost/db"
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False
CORS(app)
db = SQLAlchemy(app)

报错情况 #

1. 初始错误：

ValueError: mutable default <class 'sqlalchemy.ext.associationproxy.AmbiguousAssociationProxyInstance'> for field x is not allowed: use default_factory

2. 添加default_factory=None后报错：

sqlalchemy.exc.ArgumentError: Attribute 'x' on class <class 'api.model.One'> includes dataclasses argument(s): 'default_factory' but class does not specify SQLAlchemy native dataclass configuration.

问题根源 #

1. Dataclass兼容性问题：原生@dataclass无法识别SQLAlchemy的association_proxy类型，将其视为可变默认值触发第一个报错；添加default_factory后，普通dataclass不支持SQLAlchemy的ORM字段配置，导致第二个报错。
2. 关联关系定义错误：中间表带额外字段时，不能用secondary参数的多对多模式，必须采用关联对象模式（拆分为两个一对多关系）。
3. 类型定义歧义：One与Many是一对多关系，many_link对应多个Many实例，association_proxy指向单个x字段会导致歧义，应定义为集合类型。

修复步骤与代码示例 #

1. 改用SQLAlchemy原生Dataclass装饰器 #

替换原生@dataclass为@db.dataclass，让SQLAlchemy处理ORM字段与dataclass的映射，解决默认值配置冲突。

2. 重构关联关系（适配带额外字段的中间表） #

移除Main模型中secondary="manys"的多对多关系，改为通过中间表Many建立双向一对多关联，再用association_proxy实现跨表访问。

3. 修正类型定义 #

将many_x的类型改为集合类型（如List[bool]），匹配一对多关系的实际数据结构。

修正后的models.py

from typing import List
from dataclasses import dataclass
from sqlalchemy.orm import Mapped
from sqlalchemy.ext.associationproxy import association_proxy
from . import db


@db.dataclass
class Main(db.Model):
    __tablename__ = "main"
    id: int = db.Column(db.Integer, primary_key=True)
    
    # 与中间表Many的双向一对多关系
    manys: Mapped[List["Many"]] = db.relationship(back_populates="main")
    # 通过association_proxy关联One对象集合
    ones: Mapped[List["One"]] = association_proxy("manys", "one")
    # 通过association_proxy获取所有关联的x字段值集合
    ones_x: Mapped[List[bool]] = association_proxy("manys", "x")


@db.dataclass
class Many(db.Model):
    __tablename__ = "manys"
    main_id = db.Column(db.Integer, db.ForeignKey("main.id"), primary_key=True)
    one_id = db.Column(db.Integer, db.ForeignKey("one.id"), primary_key=True)
    x = db.Column(db.Boolean, nullable=False, default=False)
    
    # 与Main、One的双向关联
    main: Mapped["Main"] = db.relationship(back_populates="manys")
    one: Mapped["One"] = db.relationship(back_populates="manys")


@db.dataclass
class One(db.Model):
    __tablename__ = "ones"
    id: int = db.Column(db.Integer, primary_key=True)
    name: str = db.Column(db.String, nullable=False)
    other_id: int = db.Column(db.Integer, nullable=False)
    
    # 与中间表Many的双向一对多关系
    manys: Mapped[List["Many"]] = db.relationship(back_populates="one")
    # 获取该One所有关联的x字段值集合
    many_x: Mapped[List[bool]] = association_proxy("manys", "x")

关键说明 #

• 使用@db.dataclass后，SQLAlchemy会自动同步ORM字段与dataclass的属性，避免原生dataclass的默认值校验问题。
• 关联对象模式是处理带额外字段中间表的标准方式，通过中间表的双向一对多关系，结合association_proxy可以实现类似多对多的便捷访问，同时能获取中间表的额外字段。
• association_proxy从集合关系中提取字段时，返回的是集合类型，因此类型定义需对应为List[xxx]。

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