SQLAlchemy ORM 提升效率的关键在于切换数据库只需改连接串和驱动，不改模型与业务代码；filter() 比 filter_by() 更灵活常用；commit 前需检查主键、唯一约束及脏数据；joinedload 在一对多时易引发性能问题；高频查询字段须手动建索引。
直接改模型、换连接串，就能切库不改业务代码——这才是 SQLAlchemy ORM 真正提升效率的地方，不是写得少，而是改得少、查得稳、扩得快。
怎么让一套模型同时跑在 SQLite 和 MySQL 上
关键不在模型本身，而在 create_engine 的连接字符串和驱动安装。SQLite 用内置驱动，MySQL 必须装 pymysql 或 mysql-connector-python：
-
sqlite:///app.db：本地开发直接开箱即用，无需额外依赖 -
mysql+pymysql://user:pass@127.0.0.1:3306/mydb：上线前 pip install pymysql，改一行连接串即可 - 别硬编码数据库类型到模型里——
Column定义中避免用mysql或sqlite特有参数（如mysql_charset），否则切换时会报错
为什么 filter() 比 filter_by() 更常用
filter() 支持任意表达式，filter_by() 只能做等值匹配。实际开发中，模糊查询、范围判断、多表关联条件都绕不开 filter()：
- 模糊匹配：
.filter(User.name.like('%admin%')) - 多字段 AND：
.filter(User.status == 1, User.created_at > datetime(2024, 1, 1)) - IN 查询：
.filter(User.id.in_([1, 2, 3])) -
filter_by(name='alice')看起来简洁，但一加个!=或is None就得切回filter()，反而增加认知切换成本
session.commit() 前必须检查什么
不是所有 add() 都能直接 commit()，尤其涉及外键、唯一约束或自增主键时：
立即学习“Python免费学习笔记（深入）”；
- 插入后立刻读
new_obj.id？确保模型定义了primary_key=True且数据库支持自增（SQLite/MySQL 默认支持，Oracle 需显式配Sequence） - 批量插入含重复唯一字段（如 email）？
commit()会抛IntegrityError，得提前用session.execute(select(...))查重，或捕获异常后session.rollback() - 修改对象属性后没
add()？commit()仍会生效——SQLAlchemy 自动跟踪已查出对象的变更，这是“脏检查”机制，不是 bug
急加载（joinedload）什么时候反而拖慢性能
不是所有关联都该用 joinedload。它本质是 SQL JOIN，数据量大时可能爆炸式膨胀：
- 一对多关系（如 User → Orders），若每个 User 平均有 50+ 订单，
joinedload(User.orders)会把用户信息重复刷 50 次，网络和内存开销陡增 - 正确做法：
selectinload(User.orders)发起第二条 IN 查询，更可控；或干脆分两步查，先取用户 ID 列表，再query.filter(Order.user_id.in_(...)) - 只有真正需要“单次往返取全量关联数据”时（比如导出报表、生成 JSON），才用
joinedload
最易被忽略的点：SQLAlchemy 不会自动帮你建索引。filter() 里高频查询的字段（如 user_status、created_at），必须手动在数据库里加索引——ORM 层完全不管这事，性能瓶颈往往卡在这里。
