Flask+SQLAlchemy报列不存在错误，但SQLite中存在对应列求助

问题描述 #

使用Flask + SQLAlchemy时触发column not found错误，但SQLite数据库中已存在对应列和数据。相关代码如下：

plot_vends函数 #

def plot_vends():
    return jsonify([[product, timestamp] for product, timestamp in Vend.query.with_entities(Vend.product, Vend.timestamp).all()])

路由代码 #

@app.route('/')
def index():
    return render_template('index.html', products=plot_vends())

数据库模型 #

class Vend(db.Model):

    id = db.Column(db.Integer, primary_key=True)    
    user =  db.Column(db.String(64))
    product = db.Column(db.String(64))
    price = db.Column(db.Integer())
    timestamp = db.Column(db.DateTime()) 

    def __init__(self, user, product, price, timestamp):
        self.user = user
        self.product = product
        self.price = price
        self.timestamp = timestamp

    def __repr__(self):
        return "<Vend ('%s','%s','%s','%s')>" % (self.user, self.product, self.price, self.timestamp)

排查与解决步骤 #

1. 同步模型与数据库表结构 #

SQLAlchemy不会自动将模型修改同步到现有数据库。如果是后期给Vend模型新增了product或timestamp列，旧数据库表不会自动生成这些字段：

• 开发环境快速修复：删除现有数据库文件（如app.db），在Flask Shell中执行db.create_all()重新生成匹配模型的表结构。
• 需保留数据场景：使用Flask-Migrate做迁移，依次执行flask db init、flask db migrate、flask db upgrade完成结构同步。

2. 校验数据库真实表结构 #

直接查看SQLite数据库的实际结构，确认列是否存在：

1. 用sqlite3命令行打开目标数据库：sqlite3 your_database.db
2. 执行命令查看表结构：PRAGMA table_info(vend);（SQLAlchemy默认将类名转为小写作为表名）
3. 核对输出的列名、数据类型是否与模型定义完全一致。

3. 确认数据库连接路径 #

检查Flask实际连接的数据库文件是否与你手动查看的一致：
在代码中添加打印语句输出数据库URI：

print(app.config['SQLALCHEMY_DATABASE_URI'])

避免因配置错误连接到旧的或其他数据库文件。

4. 验证模型引用正确性 #

确保plot_vends函数和路由中导入的Vend类是最新的模型定义，排查是否存在多文件导入、命名冲突导致引用了旧的模型版本。

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