sqlalchemy_database_uri必须在db.init_app(app)前配置，否则报runtimeerror；__tablename__需显式指定以避免大小写问题；create_all()不更新表结构，线上须用flask-migrate；查询结果为模型实例，json序列化前需转字典。
Flask-SQLAlchemy 初始化时 SQLALCHEMY_DATABASE_URI 必须提前设好
没配好这个配置项，应用一启动就报 RuntimeError: application not registered on db instance 或直接连不上库——不是 db 没初始化，而是它压根不知道连哪儿。
常见错误是把 db = SQLAlchemy() 写在模块顶层，但等 app.config['SQLALCHEMY_DATABASE_URI'] 在后面才赋值。Flask-SQLAlchemy 初始化时会立刻读取配置，晚了就无效。
-
SQLALCHEMY_DATABASE_URI必须在db.init_app(app)之前设置，推荐在创建 app 实例后、调用init_app前就完成 - 开发环境建议用 SQLite：
sqlite:///./app.db；注意路径是相对当前工作目录，不是文件所在目录 - 生产环境别硬编码密码，从环境变量读：
os.getenv('DATABASE_URL', 'sqlite:///./app.db') - MySQL/PostgreSQL 要加驱动名，比如
mysql+pymysql://...或postgresql+psycopg2://...，缺驱动会报ModuleNotFoundError
模型定义里 __tablename__ 不写会怎样
不显式指定 __tablename__，SQLAlchemy 默认用类名小写（User → user），看着省事，但一旦类名带大写或下划线（比如 UserProfile），表名就变成 userprofile，跟数据库实际表对不上，查不到数据还找不到错在哪。
- 始终显式写
__tablename__ = 'user_profile'，和数据库保持一致 - 字段名也别依赖默认：用
Column('real_column_name', String)明确映射，尤其对接遗留库时 - 如果用了
db.Table定义关联表，表名必须和数据库里完全一致，大小写敏感（PostgreSQL 尤其要注意）
db.create_all() 不会更新已有表结构
改了模型字段再跑一遍 db.create_all()，不会加列、改类型、删字段——它只建缺失的表，已存在的表原封不动。线上改结构，靠它会漏掉迁移。
- 开发阶段可配合
drop_all()清库重来，但仅限本地：db.drop_all(); db.create_all() - 真实环境必须用
flask-migrate：先flask db migrate -m "add email"，再flask db upgrade -
create_all()不检查字段变更，比如把String(50)改成String(100)，它不吭声，但数据库里还是 50
查询结果不是 dict，是模型实例，别直接 JSON 序列化
写 return jsonify(User.query.all()) 会报 TypeError: Object of type User is not JSON serializable——因为 SQLAlchemy 返回的是带方法和关系的实例对象，不是纯数据。
- 简单场景用
model.__dict__取字段，但注意它包含_sa_instance_state这种内部属性，得过滤掉 - 更稳妥是手动构造字典：
{'id': u.id, 'name': u.name}，或用sqlalchemy.orm.attributes.instance_dict(u)（需排除私有键） - 复杂嵌套关系（如用户+订单列表）别手写，考虑用
marshmallow或pydantic做序列化层，否则容易漏字段或循环引用
