Flask迁移PostgreSQL调用create_all报relation不存在错误

• PostgreSQL和SQLite的事务机制存在本质差异：SQLite执行CREATE TABLE这类DDL语句时会触发隐式自动提交，after_create事件触发时表已经对所有会话可见，因此插入默认用户的逻辑可以正常执行。
• PostgreSQL的DDL是事务性的：db.create_all()执行建表操作时，所有建表语句都在同一个未提交的事务中，默认事务隔离级别为读已提交，原事件回调中直接使用全局db.session发起插入请求时，这个独立会话无法感知到还未提交的user表，因此抛出relation "user" does not exist错误。

两种可直接落地的方案，优先选择第一种更贴合事件监听的设计逻辑：

方案1：使用事件传入的数据库连接执行插入 #

after_create事件回调会接收当前执行建表的连接参数，基于这个连接创建会话即可和建表操作处于同一个事务上下文，能正常识别到刚创建的表：

from sqlalchemy import event

@event.listens_for(User.__table__, 'after_create')
def create_default_user(target, connection, **kwargs): 
    print("Create User Table - Default User")
    # 绑定当前建表用的连接创建会话，不要直接用全局db.session
    session = db.create_scoped_session(options={'bind': connection})
    session.add(User(username="admin", email="admin@plop.com", password=generate_password_hash("admin", "sha256")))
    session.commit()
    session.remove()

方案2：建表完成提交后再插入默认数据 #

放弃在after_create事件中插入默认数据，等create_all()执行完成、所有表结构提交完成后，再做默认数据初始化，同时加存在性判断避免重复插入：

# 应用启动初始化逻辑
with app.app_context():
    db.create_all()
    # 检查默认管理员是否存在，不存在则创建
    if not User.query.filter_by(username="admin").first():
        db.session.add(User(username="admin", email="admin@plop.com", password=generate_password_hash("admin", "sha256")))
        db.session.commit()

补充注意：如果修复后仍报错，检查PostgreSQL连接账号是否有对应schema的建表、读写权限，同时确认模型__tablename__配置和实际查询的表名一致（PostgreSQL默认标识符大小写敏感，未加引号的表名会自动转为小写存储）。

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