SQLAlchemy调用db.create_all()无法创建SQLite表的问题求助

问题排查与解决方案 #

问题根源分析

出现no such table: sku_model错误的核心原因是SQLAlchemy实例不统一，同时可能伴随数据库路径权限、模型注册时机等问题：

1. 项目中同时在database.py和models.py创建了独立的db实例，导致模型与应用绑定的数据库实例不匹配，db.create_all()无法识别到需要创建的表。
2. 旧数据库文件残留或程序无/tmp目录读写权限，导致表创建失败但无明显报错。
3. 模型导入时机或应用上下文不正确，导致db.create_all()未正确执行。

具体修复步骤

1. 统一SQLAlchemy实例

删除models.py中自行创建的db实例，改为导入database.py的全局db，确保所有模块使用同一个数据库实例：

修改models.py：

from app.database import db  # 替换原有的db创建代码

class SKUModel(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    sku = db.Column(db.String)
    product_title = db.Column(db.String)
    quantity = db.Column(db.Integer)
    price = db.Column(db.Float)

    # JSON serializer
    def to_json(self):
        return { 
            "id": self.id,
            "sku": self.sku,
            "product_title": self.product_title,
            "quantity": self.quantity,
            "price": self.price,
        }

同步更新其他文件的db导入逻辑：

• app.py：将from app.models import SKUModel, db改为from app.database import db; from app.models import SKUModel
• routes.py/core.py：保持从app.models导入SKUModel，db可直接从app.database导入（或从app.models导入，因为models.py已统一使用database的db）

2. 清理旧数据库并验证权限

• 删除残留的旧数据库文件：rm /tmp/database.db
• 验证程序运行用户对/tmp目录的读写权限：手动创建测试文件touch /tmp/test.db && rm /tmp/test.db，确保无权限报错。

3. 增强create_all()的错误排查

修改setup_database函数，添加异常捕获与日志输出，确认表创建过程：

def setup_database(app):
    with app.app_context():
        try:
            db.create_all()
            app.logger.info("DB init! Tables created successfully.")
        except Exception as e:
            app.logger.error(f"Failed to create tables: {str(e)}")

4. 确认应用上下文与启动流程

确保setup_database在应用实例创建后调用，开启debug模式方便查看日志：

if __name__ == "__main__":
    app = create_app()
    app.logger.info("Starting app, initializing database...")
    setup_database(app)
    app.run(debug=True)

验证方法

启动程序后，通过SQLite命令行工具检查表是否创建成功：

sqlite3 /tmp/database.db
sqlite> .tables

若输出sku_model，则表创建成功，可正常操作SKU数据。

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