Rspec测试Rails并发索引迁移时回滚报错排查

我正在为Postgres数据库编写Rspec测试，验证基于Rails ActiveRecord的新迁移。迁移文件中通过以下代码添加并发索引：

disable_ddl_transaction!

add_index :table_name, [:column_1, :column_2], algorithm: :concurrently

迁移及开发环境回滚均无问题，但在测试文件中回滚至旧版本迁移（需删除该索引）时，出现如下错误：

ActiveRecord::StatementInvalid:
       PG::InFailedSqlTransaction: ERROR:  current transaction is aborted, commands ignored until end of transaction block
       : SELECT pg_advisory_unlock(7815322980726126075)
     # ./spec/migrations/<FILE_NAME>.rb:17:in `block (3 levels) in <top (required)>'
     # ------------------
     # --- Caused by: ---
     # PG::ActiveSqlTransaction:
     #   ERROR:  DROP INDEX CONCURRENTLY cannot run inside a transaction block

测试中执行回滚的代码如下：

before :each do
  ActiveRecord::MigrationContext.new(migration_paths).migrate(previous_version)
  ConferenceLink.reset_column_information
end

想了解为何开发环境回滚正常，但测试环境触发该Postgres错误。

核心原因 #

• 开发环境逻辑：开发环境中，Rails会自动适配迁移的事务设置——因为你的迁移文件开头加了disable_ddl_transaction!，回滚时Rails会沿用这个配置，在无事务环境下执行DROP INDEX CONCURRENTLY，避开了Postgres的事务限制。
• 测试环境事务包裹：Rspec默认会给每个测试用例套一个全局事务，所有操作都在这个事务内运行。你在before :each里调用的迁移回滚操作也被包含其中，而Postgres明确禁止在事务块内执行DROP INDEX CONCURRENTLY，这就是报错的直接原因。

可行解决方案 #

1. 禁用测试用例的事务
   在测试文件顶部添加配置，让测试脱离事务包裹：

RSpec.describe YourMigrationSpec, type: :migration do
  use_transactional_fixtures = false
  # 或者针对当前测试组禁用事务
  disable_transactional_fixtures!

  # 测试代码...
end

这样迁移回滚操作就能在无事务环境下执行，符合Postgres对DROP INDEX CONCURRENTLY的要求。

2. 环境区分迁移逻辑
   如果测试环境不需要严格模拟生产的并发索引行为，可以在迁移文件中根据环境切换索引创建方式：

disable_ddl_transaction! unless Rails.env.test?

add_index :table_name, [:column_1, :column_2], 
          algorithm: Rails.env.test? ? :default : :concurrently

测试环境用普通索引，回滚时就不会触发并发操作的事务限制，同时不影响生产环境的并发索引逻辑。

3. 手动清理事务上下文
   如果不能全局禁用测试事务，可以在执行迁移前手动结束当前事务：

before :each do
  # 主动回滚并关闭当前测试事务
  ActiveRecord::Base.connection.execute("ROLLBACK") if ActiveRecord::Base.connection.transaction_open?
  ActiveRecord::MigrationContext.new(migration_paths).migrate(previous_version)
  ConferenceLink.reset_column_information
end

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