Flask应用连接SQLite数据库报错：user表不存在，请求解决

核心排查步骤 #

1. 验证数据库文件路径与配置 #

• 打印当前数据库配置路径，确认指向的文件是否正确：

  from your_app import app
  print(app.config['SQLALCHEMY_DATABASE_URI'])
  

• 根据输出路径找到对应的.db文件：
  • 如果文件不存在：说明数据库未初始化，需执行创建表操作
  • 如果文件存在：用SQLite浏览器打开，直接查看是否存在user表

2. 确认User模型定义合规 #

• 模型必须继承db.Model，字段定义完整，示例：

  from flask_sqlalchemy import SQLAlchemy
  
  db = SQLAlchemy()
  
  class User(db.Model):
      id = db.Column(db.Integer, primary_key=True)
      username = db.Column(db.String(80), unique=True, nullable=False)
      # 其他业务字段...
  

• 若手动指定__tablename__，确保值为user（SQLite默认将类名转为小写作为表名，除非显式指定）

3. 确保表已被正确创建 #

• 检查db.create_all()的执行逻辑：必须在Flask应用上下文内执行，正确写法：

  from your_app import app, db
  
  with app.app_context():
      db.create_all()  # 此操作会创建所有已定义的模型表
  

• 若使用Flask-Migrate管理数据库版本：
  • 确认已执行初始化命令：flask db init
  • 生成迁移脚本：flask db migrate -m "create user table"
  • 应用迁移到数据库：flask db upgrade

4. 排查上下文与环境问题 #

• 若项目使用蓝图或多应用结构，确保db对象与当前运行的Flask实例绑定，避免跨上下文操作
• 检查开发/测试环境配置是否冲突，比如不同环境指向了不同的.db文件

5. 权限与文件完整性检查 #

• 确认运行Flask进程的用户对.db文件及所在目录有读写权限
• 若数据库文件损坏，可备份后删除文件，重新执行表创建操作

需要补充的信息（便于精准定位） #

• 触发报错的具体SQL语句
• User模型的完整代码
• Flask应用中数据库配置的代码片段
• 初始化数据库的代码逻辑

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