Flask-SQLAlchemy 配置详解：从基础到高级应用

缪阔孝Ruler

于 2025-06-09 09:21:59 发布

阅读量340

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00125/article/details/148527408

Flask-SQLAlchemy 配置详解：从基础到高级应用

flask-sqlalchemy Adds SQLAlchemy support to Flask 项目地址: https://gitcode.com/gh_mirrors/fl/flask-sqlalchemy

配置概述

Flask-SQLAlchemy 作为 Flask 与 SQLAlchemy 的集成工具，提供了便捷的数据库操作方式。其配置系统设计精巧，允许开发者通过 Flask 应用的 app.config 来管理各种数据库连接参数。所有配置必须在初始化 SQLAlchemy 实例之前完成，配置一旦加载后不会再次读取。

核心配置参数详解

数据库连接配置

SQLALCHEMY_DATABASE_URI 是最基础的配置项，用于指定默认数据库的连接字符串。它可以是标准的 URI 字符串，也可以是 SQLAlchemy 的 URL 对象。从 3.0 版本开始，不再默认使用内存中的 SQLite 数据库，开发者必须显式配置此参数或 SQLALCHEMY_BINDS。

典型的数据库连接字符串格式如下：

dialect://username:password@host:port/database

SQLALCHEMY_BINDS 允许配置多个数据库连接，是一个字典结构，键为绑定名称，值为连接配置。值可以是连接字符串，也可以是包含 url 键和其他引擎参数的字典。None 键用于配置默认绑定。

引擎选项配置

SQLALCHEMY_ENGINE_OPTIONS 提供了对默认数据库引擎的精细控制，可以传递各种参数给 sqlalchemy.create_engine。从 2.4 版本引入，3.0 版本后仅应用于默认绑定。

SQLALCHEMY_ECHO 是一个调试选项，启用后会输出所有 SQL 查询和连接池操作到日志，方便开发者调试数据库交互。3.0 版本后同时控制 echo 和 echo_pool 参数。

高级功能配置

SQLALCHEMY_RECORD_QUERIES 启用后会记录请求期间的所有查询，可通过 get_recorded_queries() 获取。3.0 版本后不再自动在调试或测试模式下启用。

SQLALCHEMY_TRACK_MODIFICATIONS 控制是否跟踪模型的修改操作，会发送 models_committed 和 before_models_committed 信号。由于会带来性能开销，3.0 版本后默认禁用。

连接字符串示例

不同数据库的连接字符串示例：

# SQLite（相对路径，基于 Flask 实例路径）
sqlite:///project.db

# SQLite（绝对路径）
sqlite:absolute/path/to/project.db

# PostgreSQL
postgresql://user:password@localhost/dbname

# MySQL/MariaDB
mysql://user:password@localhost/dbname

注意 SQLite 的特殊性：相对路径使用三个斜杠，绝对路径使用四个斜杠（在 Linux/Mac 上）。