declarative_base() 是 sqlalchemy orm 模型的必需基类生成函数，不调用则 base 未定义导致 nameerror；必须显式执行 base = declarative_base() 后才能定义模型类。
SQLAlchemy 的 declarative_base() 是什么，不调用会怎样
它不是可选的“初始化步骤”，而是所有 ORM 模型类的共同父类来源。没调用 declarative_base() 就直接写 class User(Base)，Python 会报 NameError: name 'Base' is not defined——因为 Base 根本不存在。
常见错误是复制了教程代码但漏掉这行，或误以为 from sqlalchemy.ext.declarative import declarative_base 导入后就自动可用。其实导入只是拿到函数，必须显式调用一次才能生成真正的基类。
-
Base = declarative_base()必须在定义任何模型类前执行，且通常只做一次 - 多个模块中需要模型时，应把
Base单独放在models.py中，其他地方from models import Base - 如果用了
AsyncEngine（异步），仍要用普通declarative_base()，不用额外换函数
字段定义里 Column(String) 和 Column(String(50)) 差在哪
差在数据库层面是否真正限制长度，以及某些方言（如 MySQL）建表时会不会报错。
String 不带长度参数，在 SQLite 和 PostgreSQL 中能正常工作（它们把 TEXT 当无界字符串），但在 MySQL 中，CREATE TABLE 会失败：MySQL 要求 VARCHAR 必须指定长度，而 SQLAlchemy 默认把它映射为 VARCHAR 而非 TEXT。
- 显式写
Column(String(50))→ 大部分方言生成VARCHAR(50) - 只写
Column(String)→ SQLite/PG 生成TEXT，MySQL 报错或退化为VARCHAR(255)（取决于 SQLAlchemy 版本和配置） - 想强制用
TEXT类型（比如存长文本），得写Column(Text)，别依赖String()的模糊行为
为什么 session.add(obj) 后查不到新数据
因为还没提交，对象只在 session 的“待插入”队列里，数据库里确实没有这行记录。
典型场景是写完 add() 紧接着就 session.query(User).filter(...).first()，结果返回 None。这不是 bug，是预期行为——SQLAlchemy 默认事务隔离级别下，未提交的变更对其他查询不可见，包括同一 session 内的后续查询（除非你用 refresh 或 flush）。
- 加完必须配
session.commit()才真正入库 - 如果只是想让对象获得主键（比如自增 ID），可用
session.flush()，它把 SQL 发给数据库但不提交事务；之后obj.id就有值了 - 用
session.expire_on_commit=False创建 session 可避免 commit 后自动过期对象，但一般没必要改这个默认
relationship() 的 back_populates 和 backref 到底怎么选
backref 是快捷写法，一行顶两行；back_populates 是显式写法，两边都要定义。选哪个不看“方便”，而看“控制权”。
新手常踩的坑是混用：一边用 backref，另一边又手动加 relationship 配 back_populates，结果 SQLAlchemy 报 sqlalchemy.exc.ArgumentError，说关系重复注册。
- 单向关联（比如只从
User查posts，不需要从Post回找user），直接用relationship(..., backref=...)最省事 - 双向关联且需要精细控制（比如一边设
lazy='select'，另一边设lazy='joined'），必须用back_populates，并在两个类里都写relationship() -
backref本质是语法糖，底层仍会生成两个relationship，所以它不能替代显式配置的灵活性
ORM 映射看着是 Python 类和属性，实际每一步都在和数据库类型、事务边界、SQL 生成逻辑打交道。最常被忽略的，是那些“没报错但结果不对”的情况——比如 flush 和 commit 的区别、String 长度隐含的方言差异、relationship 的双向注册冲突。这些点不写进文档里，但一碰就卡住。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
