Ruby能否不加载原始模块就重定义第三方Gem的冲突模块？

核心问题 #

第三方Gem里的模块错误使用extend ActiveModel::Callbacks，而新版ActiveSupport::Callbacks的included块会调用class_attribute——这个方法是Rails给Class类专属添加的，Module类并没有，导致一加载Gem就触发异常。常规猴子补丁需要先加载Gem代码，但现在加载就报错，必须提前做干预。

方案一：先给Module补全class_attribute方法 #

在加载目标Gem之前，先给Module类添加简易的class_attribute实现，让Gem加载时不会因找不到方法报错：

# 放在Gemfile引入该Gem之前，或者项目初始化代码最开头
Module.class_eval do
  def class_attribute(*attrs)
    attrs.each do |attr|
      define_singleton_method(attr) { instance_variable_get("@#{attr}") }
      define_singleton_method("#{attr}=") { |val| instance_variable_set("@#{attr}", val) }
    end
  end
end

# 现在再加载Gem就不会报错了
require 'gem_name'

加载完成后，再修正有问题的模块，把错误的extend改成符合Rails规范的用法：

GemName::ProblematicModule.class_eval do
  # 先清理之前错误extend带来的多余方法
  singleton_class.send(:remove_method, :__callbacks) if respond_to?(:__callbacks)
  singleton_class.send(:remove_method, :__callbacks=) if respond_to?(:__callbacks=)

  # 改成正确的include方式（模块是给类用的，类include该模块后就能获得回调能力）
  include ActiveModel::Callbacks
  # 如果需要定义具体回调，比如:create，可以添加：
  # define_model_callbacks :create
end

方案二：修改ActiveSupport::Callbacks的执行逻辑 #

另一种思路是提前修改ActiveSupport::Callbacks的included块，让它在模块上执行时跳过class_attribute的调用：

# 加载Gem前先修改ActiveSupport::Callbacks
ActiveSupport::Callbacks.class_eval do
  original_included = instance_method(:included)

  define_method(:included) do |base|
    if base.is_a?(Class)
      # 针对类的情况按原有逻辑执行
      original_included.bind(self).call(base)
    else
      # 针对模块的情况手动处理，避免调用class_attribute
      base.extend ActiveSupport::DescendantsTracker
      base.instance_variable_set(:@__callbacks, {})
      base.define_singleton_method(:__callbacks) { instance_variable_get(:@__callbacks) }
    end
  end
end

# 加载Gem
require 'gem_name'

# 后续可按需调整模块的回调逻辑

补充说明 #

正常情况下，ActiveModel::Callbacks应该被类include，而非被模块extend——Gem的写法本身不符合Rails的设计规范，所以我们需要先打“急救补丁”让它能正常加载，再修正为正确的用法。

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