使用Alembic执行添加列迁移超时无响应，如何解决？

针对你遇到的Alembic执行添加列操作卡住的情况，可按以下步骤排查和解决：

• 检查表锁情况
  执行SQL查询查看products2表是否被其他事务锁定：

  SELECT 
      pid, 
      mode, 
      granted, 
      relation::regclass
  FROM pg_locks 
  WHERE relation = 'products2'::regclass;
  

  若发现未释放的锁（比如存在未提交的读写事务），找到对应的pid并终止进程：

  SELECT pg_terminate_backend(锁定的pid);
  

  之后重新执行Alembic迁移。

• 核查GCP数据库资源状态
  登录Google Cloud Console的Cloud SQL实例详情页，查看CPU、内存使用率指标。如果资源接近饱和（比如CPU使用率100%），会导致DDL操作缓慢。可临时升级实例规格，完成迁移后再降级回原配置。

• 尝试给列添加默认值
  修改迁移代码，为新增列指定服务器端默认值，验证是否因隐性处理逻辑导致卡住：

  def upgrade() -> None:
      op.add_column('products2', sa.Column(
          'product_status', sa.String(255), server_default=''))
  

  若执行成功，后续可再通过迁移移除默认值。

• 手动执行DDL语句
  先终止卡住的Alembic进程，直接在GCP SQL控制台或psql中执行添加列语句：

  ALTER TABLE products2 ADD COLUMN product_status VARCHAR(255);
  

  若手动执行成功，用以下命令标记Alembic版本为已应用：

  alembic stamp d6fe1dec4bcd
  

• 检查表的触发器与约束
  查询表上的触发器：

  SELECT tgname FROM pg_trigger WHERE tgrelid = 'products2'::regclass;
  

  若存在行级触发器，添加列时可能触发对现有行的额外操作。可临时禁用触发器，完成添加后再启用：

  ALTER TABLE products2 DISABLE TRIGGER ALL;
  ALTER TABLE products2 ADD COLUMN product_status VARCHAR(255);
  ALTER TABLE products2 ENABLE TRIGGER ALL;
  

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