Flask SQLAlchemy一对多外键关联报错：UnmappedInstanceError排查

常见错误原因 #

• 直接添加字符串到数据库会话：调用db.session.add()时传入了字符串，而非User或Login的模型实例。SQLAlchemy仅能处理映射的模型对象，无法识别普通字符串。
• 关联关系赋值错误：设置一对多关联时，误将字符串赋值给关系属性（比如login.user = "xxx"），或是给外键字段传入了字符串而非合法的外键值（例如外键为整数类型，你传了字符串格式的ID）。
• 批量添加时混入字符串：使用db.session.add_all()时，传入的列表中包含字符串元素，而非全部是模型实例。

正确与错误代码示例 #

错误用法 #

# 错误：直接添加字符串
db.session.add("test_user")

# 错误：关联时传入字符串
login = Login(ip="127.0.0.1")
login.user = "admin"  # 应该传入User实例
db.session.add(login)

正确用法 #

# 创建User实例并添加
user = User(username="test_user", email="test@example.com")
db.session.add(user)

# 正确设置关联：传入User实例或合法外键值
login = Login(ip="127.0.0.1")
login.user = user  # 或者 login.user_id = user.id（需确保user已提交或ID存在）
db.session.add(login)

# 提交会话
db.session.commit()

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