Rails 6项目中自定义Ruby Gem类方法在ActiveRecord模型调用报NoMethodError

• 错误的核心是RubyGemName::ClassMethods的方法定义逻辑不符合模块注入规则
  • 你在ClassMethods模块内写的def self.ruby_gem_name_class_method，本质是定义了一个ClassMethods模块自己的单例方法。这类方法只存在于ClassMethods对象本身，不会在其他类/模块extend当前模块时，被注入到目标对象的方法查找链中。
  • 独立IRB环境下测试能正常运行，是因为当时直接调用RubyGemName::ClassMethods.ruby_gem_name_class_method，走的是ClassMethods自身的单例方法查找路径，完全没有经过模块extend的注入流程，所以问题没有暴露。
  • 在Cart模型里执行extend RubyGemName::ClassMethods时，extend机制只会把模块内的实例方法挂载为当前类的类方法。由于你根本没有在ClassMethods里定义对应的实例方法，自然会抛出NoMethodError。
• 代码里的extend ClassMethods属于完全冗余的逻辑：这行代码只是为了让RubyGemName模块自身能调用之前定义的单例方法，没有任何业务模型注入能力，还会造成逻辑混淆。

1. 调整Gem内lib/ruby_gem_name/class_methods.rb的代码：移除方法定义前的self.前缀，同时删掉冗余的extend ClassMethods行。修正后的代码如下：

module RubyGemName
  module ClassMethods
    # 不带self的定义是模块的实例方法，extend时会自动成为接收方的类方法
    def ruby_gem_name_class_method
      puts 'Hello'
    end
  end
end

2. 因为你是用本地path方式引入的Gem，修改Gem代码后必须退出并重启Rails控制台，才能加载到最新的Gem代码（path模式的Gem不会随Rails开发模式热更新）。
3. 重启后再执行Cart.ruby_gem_name_class_method，即可正常输出预期结果。

如果不想在每个需要用到方法的模型里手动写extend RubyGemName::ClassMethods，可以在Gem主文件里添加自动注入逻辑，让业务模型通过简单的include操作就能获得对应的类方法：
在lib/ruby_gem_name.rb中追加逻辑：

require 'active_support/concern'

module RubyGemName
  def self.included(base)
    base.extend(ClassMethods)
  end
end

调整完成后，业务模型里只需要写include RubyGemName，就可以自动获得对应的类方法，无需单独编写extend语句。

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