Flask_SQLAlchemy无法读取SQLAlchemy创建的表结构，报主键组装错误

我用原生SQLAlchemy创建了一张表，代码如下：

engine = create_engine('sqlite:///sd.sqlite')

images = Table(
   'images', meta,
   Column('id', Integer, primary_key = True),
   Column('url', String),
   ...
)

meta.create_all(engine)

操作正常，数据库已创建且能填充数据。但我想用Flask结合Flask_SQLAlchemy访问这些数据时，代码无法正常运行：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy


app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////sd.sqlite'
db = SQLAlchemy(app)
Base = db.declarative_base()

class Images(db.Model):
    with app.app_context(): #用于修复应用上下文错误
        __table__ = db.Table('images', Base.metadata),

""" with app.app_context():
    db.Model.metadata.reflect(db.engine) """

@app.route("/")
def hello_world():
    images = Images.query.all()
    return images

app.run(port=8131)

运行后出现错误：

Mapper Mapper[Images(images)] could not assemble any primary key columns for mapped table 'images'

明明已经指定了主键，请问哪里操作错误？

你的代码存在几个关键错误：

• __table__赋值错误
  你在Images类里用with app.app_context()包裹赋值，还多了个逗号，导致__table__被赋值成了一个元组（(db.Table(...),)），而不是正确的Table对象。ORM无法识别这个元组作为表结构，自然找不到主键。

• 反射元数据的方式错误
  注释掉的反射代码位置不对，而且没有正确加载已有表的结构到Flask-SQLAlchemy的元数据中。

• 视图返回值错误
  直接返回Images.query.all()的结果是不行的，Flask无法直接把ORM对象列表转换成HTTP响应，需要先序列化为可响应的格式（比如JSON）。

修正后的代码如下：

from flask import Flask, jsonify
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
# 修正数据库URI路径，和创建表时保持一致
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///sd.sqlite'
db = SQLAlchemy(app)

# 在应用上下文里反射数据库中已有的表结构
with app.app_context():
    db.Model.metadata.reflect(db.engine)

class Images(db.Model):
    # 直接关联已反射的表，无需额外上下文包裹
    __table__ = db.Model.metadata.tables['images']

@app.route("/")
def hello_world():
    images = Images.query.all()
    # 将ORM对象转换为字典列表，返回JSON格式响应
    result = [{'id': img.id, 'url': img.url} for img in images]
    return jsonify(result)

if __name__ == '__main__':
    app.run(port=8131)

关键修正点说明：

1. 修正数据库URI的路径，确保和创建表时的路径一致（原代码多写了一个斜杠）
2. 在全局应用上下文里执行metadata.reflect，加载所有已有表的结构
3. Images类直接通过db.Model.metadata.tables['images']关联已有的表，无需重新定义Table
4. 视图里把查询结果转换成字典列表，用jsonify返回标准的JSON响应

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