Alembic指定Schema配置问题：如何将表创建到geo_dev schema

以下是针对性的排查和解决步骤：

1. 验证模型的SchemaMixin实现是否正确 #

确保你的SchemaMixin确实给模型绑定了正确的schema，且未被子类覆盖：

class SchemaMixin:
    __table_args__ = {'schema': 'geo_dev'}

# 业务模型示例
class MyModel(SchemaMixin, Base):
    __tablename__ = 'my_model'
    id = sa.Column(sa.Integer, primary_key=True)
    # 其他字段...

检查所有需要放在geo_dev的模型都正确继承了这个Mixin，且没有在子类中重新定义__table_args__覆盖schema设置。

2. 完善alembic/env.py的配置 #

除了include_schemas=True，还要确保：

• target_metadata指向项目中模型的Base.metadata，而非默认空值：

  # 导入你项目的Base类
  from myapp.models import Base
  target_metadata = Base.metadata
  

• 在run_migrations_online函数的context.configure中明确schema相关配置：

  def run_migrations_online():
      connectable = engine_from_config(
          config.get_section(config.config_ini_section),
          prefix="sqlalchemy.",
          poolclass=pool.NullPool,
      )
  
      with connectable.connect() as connection:
          context.configure(
              connection=connection,
              target_metadata=target_metadata,
              include_schemas=True,
              # 可选：将alembic版本表也放在geo_dev
              version_table_schema='geo_dev'
          )
  
          with context.begin_transaction():
              context.run_migrations()
  

3. 重新生成迁移脚本（核心步骤） #

如果旧迁移脚本是在schema配置正确前生成的，脚本不会包含schema指定，必须重新生成：

1. 删除alembic/versions/目录下除缓存外的所有旧迁移文件
2. 运行自动生成命令：

   alembic revision --autogenerate -m "init tables in geo_dev schema"
   

3. 打开新生成的脚本，检查op.create_table语句是否包含schema='geo_dev'参数，示例：

   op.create_table(
       'my_model',
       sa.Column('id', sa.Integer(), nullable=False),
       # 其他字段...
       schema='geo_dev'
   )
   

4. 检查数据库连接字符串的search_path #

在数据库URL中添加search_path参数，确保默认schema包含geo_dev：

postgresql://username:password@db_host:5432/db_name?options=-csearch_path=geo_dev,public

此步骤非必须，但可避免默认schema导致的意外问题。

5. 手动修改现有迁移脚本（可选） #

若不想重新生成脚本，可直接编辑已有迁移文件，给所有表操作（create_table、add_column、create_index等）加上schema='geo_dev'参数。

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