是否存在适用于PostgreSQL的RSpec扩展，可测试数据库无变更场景？

嘿，刚好我之前也折腾过类似的需求——要确保错误请求不会偷偷修改数据库，尤其是在复杂的事件链里，手动查特定表真的太麻烦了。针对你的问题，我整理了现成工具和自定义实现两种方案，都能避开pg_stat_database在测试事务里不更新的坑：

一、现成Gem推荐 #

虽然没有完全贴合“全局数据库无变更”的开箱即用匹配器，但有几个Gem可以作为基础扩展：

• rspec-active_record_matchers：这个Gem自带了针对单模型的not_change匹配器，你可以基于它的源码扩展出全局检测的逻辑，省得从头写核心对比逻辑。
• ar_matchers：同样是针对Active Record的匹配器集合，里面的change相关方法可以反向用来做无变更检测。

不过如果要直接实现你想要的全局检测和元标签功能，自定义实现其实更灵活，而且代码量也不大，下面分享我自己在用的方案：

二、自定义实现：从匹配器到元标签 #

1. 实现not_change_database匹配器 #

在spec/support/database_matchers.rb里加这段代码：

RSpec::Matchers.define :not_change_database do
  match do |block|
    @before_counts = count_all_table_rows
    block.call
    @after_counts = count_all_table_rows
    @before_counts == @after_counts
  end

  failure_message do
    changed_tables = @before_counts.select { |table, cnt| @after_counts[table] != cnt }
    "Expected zero database changes, but these tables had row count shifts: #{changed_tables.inspect}"
  end

  private

  def count_all_table_rows
    # 排除Rails自带的系统表，只检测业务表
    tables = ActiveRecord::Base.connection.tables - %w[schema_migrations ar_internal_metadata]
    tables.each_with_object({}) do |table, counts|
      counts[table] = ActiveRecord::Base.connection.execute("SELECT COUNT(*) FROM #{table}").first['count'].to_i
    end
  end
end

之后就能像你期望的那样用：

expect { make_bad_request }.to not_change_database

2. 实现:database_changes_disallowed元标签 #

如果你想给整个describe块批量加检测，在spec/spec_helper.rb里加RSpec钩子：

RSpec.configure do |config|
  config.before(:example, :database_changes_disallowed) do
    @pre_test_table_counts = count_all_table_rows
  end

  config.after(:example, :database_changes_disallowed) do
    post_test_counts = count_all_table_rows
    changed_tables = @pre_test_table_counts.select { |table, cnt| post_test_counts[table] != cnt }

    expect(changed_tables).to be_empty, "Example marked with :database_changes_disallowed had unexpected database changes: #{changed_tables.inspect}"
  end

  private

  def count_all_table_rows
    tables = ActiveRecord::Base.connection.tables - %w[schema_migrations ar_internal_metadata]
    tables.each_with_object({}) do |table, counts|
      counts[table] = ActiveRecord::Base.connection.execute("SELECT COUNT(*) FROM #{table}").first['count'].to_i
    end
  end
end

这样就能完全按照你想要的方式写测试：

describe 'error responses', :database_changes_disallowed do
  context 'invalid form data' do
    before do
      # 你的前置设置逻辑
    end

    it 'returns 422' do
      # 测试请求和断言
    end
  end
end

三、实用小贴士 #

• 排除特殊表：如果你的应用有像user_last_active_at这类伪日志表（你提到的例外情况），直接把它们加到排除列表里就行：

  tables = ActiveRecord::Base.connection.tables - %w[schema_migrations ar_internal_metadata user_last_active]
  

• 性能优化：如果业务表特别多，每次计数会拖慢测试速度，你可以只检测核心业务表，或者只在CI环境启用这个检测。
• 事务兼容性：因为RSpec测试默认在事务里运行，这个实现完全兼容——我们是在事务内部统计行数，能准确捕捉到测试块里的所有变更，不会和事务回滚冲突。

这个方案完美避开了pg_stat_database的问题，而且完全符合你“约定优于配置”的思路，能帮你快速发现复杂逻辑里的意外数据库变更。

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