StrongMigrations 中虚拟列生成时的 quoted_scope 方法缺失问题解析

问题背景

在使用 StrongMigrations 这个 Ruby gem 进行数据库迁移时，当开发者尝试添加虚拟列(virtual column)时，可能会遇到一个特定的错误。这个错误表现为在生成 schema.rb 文件时系统抛出 NoMethodError，提示 undefined method 'quoted_scope'。

问题现象

具体来说，当开发者执行如下迁移代码时：

add_column :my_table, :active, :boolean, as: "IF(finished_at IS NULL, 1, NULL)", stored: false

系统会在生成 schema.rb 文件时报错：

Could not dump table "my_table" because of following NoMethodError 
undefined method `quoted_scope' for #<StrongMigrations::WrappedConnection:

技术分析

根本原因

这个问题源于 StrongMigrations 的 WrappedConnection 类与 ActiveRecord 内部机制之间的不兼容。具体来说：

1. ActiveRecord 的 MySQL 适配器在 schema dumper 中会调用一个名为 quoted_scope 的私有方法
2. WrappedConnection 类使用了 delegate_missing_to :@connection 来委托方法调用
3. Ruby 的 delegate_missing_to 机制默认不会委托私有方法
4. 因此当 schema dumper 尝试通过 send 调用这个私有方法时，方法查找失败

解决方案

正确的解决方式是在 WrappedConnection 类中显式定义 quoted_scope 方法，将调用转发给底层的连接对象。具体实现如下：

def quoted_scope(name = nil, type: nil)
  @connection.send(:quoted_scope, name, type: type)
end

技术影响

这个问题主要影响以下场景：

1. 使用 MySQL 或兼容 MySQL 的数据库
2. 尝试创建虚拟列（使用 as 参数）
3. 使用 StrongMigrations 进行迁移验证

对于不使用虚拟列或者不使用 MySQL 的用户，这个问题不会出现。

最佳实践

对于开发者来说，遇到类似问题时可以：

1. 检查错误信息中缺失的方法名
2. 确认该方法是否是 ActiveRecord 适配器的私有方法
3. 在包装类中显式定义这些需要委托的私有方法
4. 考虑是否所有私有方法都需要委托，避免过度委托

总结

StrongMigrations 作为一个增强数据库迁移安全性的工具，在与 ActiveRecord 深度集成时需要注意方法委托的边界问题。特别是对于私有方法的处理，需要开发者格外小心。这个问题也提醒我们，在使用任何包装类时，都需要全面考虑原始类的所有接口，包括公有和私有方法。

该问题已在 StrongMigrations 的最新版本中得到修复，开发者可以通过升级 gem 来解决这个问题。