使用Flask-SQLAlchemy执行SELECT查询返回None的问题排查

核心原因：Flask-SQLAlchemy与原生SQLAlchemy的数据库连接不匹配 #

你遇到的问题本质是Flask-SQLAlchemy使用的数据库实例和手动创建引擎的数据库不是同一个，或者模型未正确绑定到Flask-SQLAlchemy的上下文。

排查步骤与修复方案 #

• 检查Flask应用的数据库URI配置
  确保Flask的SQLALCHEMY_DATABASE_URI和原生SQLAlchemy用的sqlite:///db.db完全一致。如果Flask配置未指定该参数，Flask-SQLAlchemy会默认使用内存数据库sqlite:///:memory:，查询的是空临时数据库，自然返回None。
  配置示例：

  app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///db.db'
  app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False  # 关闭不必要的性能损耗
  db = SQLAlchemy(app)
  

• 确认模型与数据库表的映射一致性
  检查Names模型定义：

  • 模型的__tablename__属性需和数据库实际表名完全匹配（SQLite默认大小写不敏感，但严格匹配更稳妥）；
  • 模型字段的名称、类型、主键设置需和数据库表字段完全对应。

• 统一使用Flask-SQLAlchemy的会话
  既然用了Flask-SQLAlchemy，无需再手动创建原生SQLAlchemy的引擎和会话，直接用db.session即可，测试代码可简化为：

  with app.app_context():
      name_flask = db.session.query(Names).get(1)
      print(name_flask)
  

• 验证数据库连接正确性
  在Flask上下文内打印当前连接的数据库路径，确认和预期一致：

  with app.app_context():
      print(db.engine.url)  # 应输出sqlite:///db.db
  

额外注意点 #

• 所有db.session的操作必须在app.app_context()范围内执行；
• 若已手动创建好数据库和表，无需调用db.create_all()（该方法仅创建模型对应的不存在的表），避免不必要的表结构同步操作。

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